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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a Club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you ll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 


WELCOME TO 
THE OFFICIAL 
MAGAZINE 


t’s been extremely hard to keep the 
existence of the Pi Zero W secret over 
the last few months. When Eben Upton : | 
first revealed that he had something new in the ——— 1 ae: 
pipeline, we spent the rest of the day discussing yee GAMING ie oe 
how much of a game-changer it could be for BLISS . = 
hackers and makers around the world. SUBSCRIBE & 

Now that the wireless connectivity of the 
Pi Zero W has been revealed, you can find SEE PAGE 28 FOR DETAILS 
the definitive breakdown - including some 
background into its making — starting on 


page 64. And beginning on page 14, this 

month’s big build integrates the new Pi model THIS MONTH: 

with Adafruit’s amazing PiGRRL handheld 

console, making it even better than before. 
To celebrate even further, we’ve got a new 

subscription offer that lets you walk away 

with your own Pi Zero W and brand-new 

official Pi Zero case that comes with three 42 MAKE AN ALEXA-POWERED ROBOT 

; This Alexabot responds to your emotions 

interchangeable covers. You'll also get cables 


for the Camera Module, HDMI, and USB ports. 64 THE PI ZERO W IS HERE! 


Learn more on page 28. Enjoy the issue! The latest version of the Pi Zero is amazing. Here's why 
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14 BUILD THE ULTIMATE HANDHELD 


Upgrade the famous PiIGRRL console in this month's big build 


Rob Zwetsloot 74 KODI 17 REVIEWED 


Features Editor The most popular HTPC software in the world gets better 
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CREATES 


Teachers 

can use the 
curriculum to 
develop their skills 
and as inspiration 
for school lessons 


CURRICULUM 


New curriculum aims to teach the power of digital making 


he Raspberry Pi 
Foundation is determined 
to put the power of digital 
making into the hands of people 
all over the world. 
It has taken an exciting step 
in this journey, by defining its 
digital making curriculum that 
will help people everywhere learn 
new Skills. 


You can view the new curriculum 


online (magpi.cc/2kZD18}). 
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For the community 


“We have a large and diverse 


community of people who are 
interested in digital making,” 
explains Carrie Anne Philbin, 


director of education at the 
Raspberry Pi Foundation. 
Some of those people 
might use the curriculum to 
help guide and inform their 
learning, or perhaps their 
children’s education. 


Individuals who run digital 
making clubs at schools, 
community centres, and 
Raspberry Jams may draw 
on it for extra guidance. 

Some teachers may wish to use 
the curriculum as inspiration for 
what to teach their students. 

“We want to help people to 
make things so that they can 
become the inventors, creators, 
and makers of tomorrow,” says 


The Raspberry Pi Foundation is 
proud to be part of the maker 
movement. It is looking for 
feedback from the community 
on its new curriculum. 

Please add your feedback to 
this form: magpi.cc/2kKfQ3e. 
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Design basic 2D and 
3D assets. 


constructs to create 
simple programs 


components 


prototypes 


Use basic programming 


Use basic digital, analogue, 
and electromechanical 


RASPBERRY PI CURRICULUM fe (277. 


Combine 2D and 3D 
assets in the assembly 
of a project 


Combine programming 
constructs to solve 
a problem 


Combine inputs and/or 
outputs to create projects 
or solve a problem 


Use manufacturing 
techniques and tools to 
create prototype projects 


Use multiple designed 
assets in completed 
products and models 


Apply abstraction and 
decomposition to solve 
more complex problems 


Process input data to 
monitor or react to the 
environment. 


Use manufacturing 
techniques and tools to 
create a completed product 


Design multiple and 
integrating assets for 
use in complex finished 
projects and models 


Apply higher-order 
programming techniques 
to solve real-world 
problems 


Create automated systems 
to solve complex real-world 
problems 


Use basic materials and 
tools to create project 


Independently use fabrication 
systems to produce complex 
finished projects 


the digital making 
community 


Carrie Anne. Digital making, 
STEAM, project-based learning 
and tinkering are at the core of the 
Foundation’s teaching philosophy. 
This principle can be summed up 
simply as “we learn best by doing,” 
Carrie Anne tells us. 


The curriculum 
The curriculum has five strands: 
Design, Programming, Physical 
Computing, Manufacture, and 
Community and Sharing. Each of 
these encapsulates key concepts 
and skills in digital making. Users 
will progress in each strand. “You 
Start with certain skills and 
knowledge,” says Carrie Anne. 
Then, with guidance, practice, 
and understanding, you progress 
towards broader and deeper 
knowledge and competence. 
Characters are used to represent 
different levels of ability. 
Progression Starts with Creator, 
and moves onto Builder and 
Developer before becoming Maker. 
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Engage and share with 


Collaborate on digital 
making projects with 
other community members 


Learning for all 
The Raspberry Pi Curriculum is 
open to everybody, regardless of 
age or experience. “We wanted 
to avoid the age-related and 
stage-related labels that are 
often associated with a learner’s 
progress,” reveals Carrie Anne, 
“Calong with] the preconceptions, 
these labels bring.” 

The Raspberry Pi Foundation’s 
digital making curriculum is not 


Support others in the 
design and construction of 
their digital making projects 


Support others in the 
design and construction of 
their digital making projects 


ACCESS THE CURRICULUM 


A PDF version of the curriculum is available to 


download direct from the Raspberry Pi Foundation: 
magpi.cc/2kZzvuO. 


exam specifications in a fun and 
tangible way. 

The Foundation is continuing 
to expand its catalogue of free 
educational resources. It expects the 
curriculum to grow and improve, 


We want to help people to make things 
so that they can become the inventors, 
creators, and makers of tomorrow 


intended to be areplacement for 
computer science-related curricula 
around the world. 

It hopes that following the 
learning pathways will support 
the study of formal curricular and 


but is requesting input into that 
process. This is “vital” says Carrie 
Anne. So please do take a closer 
look at the program (see ‘Access 

the curriculum’) and send your 
feedback (see ‘How to get involved’). 
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HIGH SCHOOL 


REPLACES 
COMPUTERS 


WITH RASPBERRY PI 


MC2 STEM High School saint its dota Pi to boost sii delat science skills 


ne school in Cleveland, 

Ohio has chosen to use 

Raspberry Pi rather than 
buy expensive new computers. 

Instead of the Raspberry Pi 
being a limitation, the smaller 
boards have enabled MC2 STEM 
to implement a full computer 
science curriculum. 

“MC2 STEM High School is a 
unique school,” says Feowyn A 
MacKinnon, head of school. 

There are 50,000 students in the 
district, and 100% of them qualify 
for free and reduced meals. As a 
result, the technology situation 
can be quite bleak. 

The computers at MC2 were 
ten years old and hopelessly out of 
date. “More useful as paperweights 
than technology,” Feowyn tells us. 
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Amobile Fab Lab enables MC2 
STEM students to build projects and 
demonstrate them to nearby schools 


Feowyn, “we have come to depend 
completely on Raspberry Pi.” 

It turns out the Raspberry Pi 
is better for teaching STEM than 
traditional equipment. “Our 


The Raspberry P1 1s better 
for teaching STEM than 
traditional equipment 


Traditionally, schools in America 
would have a fund-raising drive to 
try to secure the money required 
for new technology. However, MC2 
had a better idea. 

“Rather than try to fund-raise 
for new technology,” explains 
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students experience an innovative 
and fun project while building 
their Raspberry Pi computers,” 
reveals Feowyn. 

MCz2 is now teaching a full year- 
long computer science curriculum 


using only Raspberry Pi computers. 


“T imagine we may be one of the 
only high schools doing this,” 
says Feowyn. 

“The Raspberry Pi then evolved 
from just a cool, fun, learning 
experience to an all-encompassing 
educational tool that our school 
and curriculum truly depend on,” 
he continues. 

MC2z2 is also the first high school 
in the US to own a mobile Fab Lab. 
“The mobile Fab Lab comes in 
handy when we want to express 
our ideas to other schools,” says 
MC2 STEM student Brandon 
(magpi.cc/2kLlaés). “I like the 
idea of project-based learning and 
being able to build stuff with your 
hands, instead of always doing 
writing work.” 
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This fake case has two sets of light pipes 
The shoddy feet on this case are a clear sign of a fake 
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Fake Raspberry Pi cases doing the rounds 


nscrupulous dealers are 

selling fake Raspberry 

Pi cases on third-party 
websites and eBay. 

Kinneir Dufort designed the 
official Raspberry Pi case. While 
there are many third-party cases 
available, the fake cases are 
intended to mimic the official case. 

The Raspberry Pi Foundation 
managed to get its hands ona 


computers, cases, cameras, and 
other products goes straight 

into our charitable fund to train 
teachers, provide free learning 
resources, teach kids, help build the 
foundations of digital making in 
schools, and much more.” 

Let The Raspberry Pi Foundation 
know if you find fake cases in the 
wild. “It damages our reputation 
when something shonky comes on 


It damages our reputation 
when something shonky 
comes on the market 


sample through a proxy pretending 
to bea Pishop. It supplied some 
pictures so the community can see 
the differences. 

“The fake cases are not as well 
made as the real thing,” says Liz 
Upton, director of communications. 
“They also deprive us of some 
much-needed charitable income. As 
you probably know, the Raspberry 
Pi Foundation is a charity. All 
the money we make from selling 


the market and it looks like we’ve 
made it,” explains Liz. “It damages 
the Raspberry Pi Foundation’s 
pockets too, which means we can’t 
do the important work in education 
we were set up to do.” 

You can see examples of 
fake versus real cases on the 
Raspberry Pi Foundation website 
(magpi.cc/2kLw3pf). Please let 
them know in the comments if you 
come across any fakes. 
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The stories we shared that 
flew around the world 


he Raspberry Pi Foundation that will help educators connect, 


has launched a new share great practice, and learn 
magazine called HelloWorld from each other.” 
(magpi.cc/2j4HuJ9). Hello World is available free, 

Hello World is a magazine about forever, for everyone online as a 
computing and digital making. downloadable PDF. The content 
It’s “written by educators, for is written to be internationally 
educators,” says the Foundation. relevant, and includes features on : 

Hello World is designed to be the most exciting developments magpl.ce/alasQz| 
cross-curricular and useful to all and best practices from around Got a Raspberry Pi that idles away most of its day? 
kinds of educators, from classroom the world. Lend some of its CPU power to science. 
teachers to librarians. While it A print version of the magazine 
includes lots of great examples of is free to the homes of serving 
how teachers are using Raspberry educators in the UK. The list of 
Pi computers in education, it is eligible subscribers is wider than 
device- and platform-neutral. you think and includes teachers, 

“As with everything we do at teaching assistants, librarians, and 
the Raspberry Pi Foundation, youth workers. Alternatively, you 
Hello World is about community can subscribe for £15 per year. 
building,” says Raspberry Pi Visit the Hello World website to 
Foundation CEO, Philip Colligan. sign up for your free subscription 
“Our goal is to provide a resource (magpi.cc/21IOKN1R). 


AGAZINE 


WELCOME TO THE M magpi.cc/2jyzU4V 


Discover the joy and art of computer 


programming with your Raspberry Pi. 
: rc ESTONE. 
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FOR COMPUTING 3 


Hello World isa 

new magazine from ; 
the Raspberry Pi magpi.cc/2hNaep3 
Foundation that's 
free to all educators This Wire and Loop game is a great project for learning 


basic circuits, electronics, and Python coding. 
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Baxter 

is the world's 
first two-armed 
robot designed 
to work together 
with people 


RoboThespian was 
the first full-sized 
humanoid robot to 
be commercially 
produced 


Rob's 

Open Source 
Android was built to 
move like a human 


New exhibition brings 100 robots under one roof 


ver 100 robots are 

on display at anew 

exhibition at the Science 
Museum, London. 

The exhibition is called ‘Robots’ 
and is set to last all summer. 

It “explores humanity’s 500-year 
quest to reimagine ourselves as 
machines,” explains the museum. 

Robots is open daily until 
3 September 2017. Tickets are on 
sale now (magpi.cc/2kLvyeO). 

Ian Blatchford, director of the 
Science Museum Group, Says: 
“This stunning exhibition explores 
the fascinating question of why, 
rather than how, we build robots. 
To look through the eyes of those 


who built, commissioned or 

gazed upon these mesmerising 
mechanical creations over the past 
500 years reveals so much about 
humanity’s hopes, fears, dreams, 
and delusions.” 

Pepper is a humanoid companion 
created to communicate with 
humans through voice and touch 
and movement. This robot invites 
visitors to touch its hands and fist- 
bump while sharing a story using 
the screen on its chest. 

Baxter, REEM Service Robot, and 
Amico are industrial robots with 
amazing precision, while robots like 
ROSA, Inhka, and RoboThespien are 
used to interact with humans. 


Some of the robots are incredibly 
lifelike. Zeno R25 has incredible 
expression, while Nao will dance, 
blow kisses, and exercise. 

Diving head-first into the 
uncanny valley is Animatronic 
baby. The baby breathes, sneezes, 
and moves its arms and legs. It’s 
designed to make you feel strong 
emotions towards a robot. 

Ben Russell, the lead curator 
of Robots, says: “Coming face to 
face with a mechanical human 
has always been a disconcerting 
experience. That sense of unease, 
of something you cannot quite put 
your finger on, goes to the heart of 
our long relationship with robots.” 


Allimages courtesy of the Science Museum 
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Tech giant asks makers for advice on AI tools 


Ooele IS Colne 10 aniive im style im 2017. line recin 
titan has exciting plans for the maker community. 

It intends to make a range of smart tools available 
this year. Google’s range of Al and machine learning 
technology could enable makers to build powerful projects. 

To make this happen, Google needs help from the 
maker community. Raspberry Pi fans are the best 
makers around, and it’s their ideas that will give the tech 
company direction. 

Here’s what Google has to say: “Hi, makers! Thank you 
for taking the time to take our survey. We at Google are 
interested in creating smart tools for makers and want 
to hear from you about what would be most helpful. Asa 
thank-you, we will share our findings with the community 
so that you can learn more about makers around 
the world.” 

The company can produce some serious tools for the 
maker community, so make sure you have your say to get 
the tools you need. 

Let Google know what you would like by filling out the 
Survey: magpi.cc/21152MR. 
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GoPiGo 


20+ new projects for your Pi robot car. 
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Build upon Adafruit's amazing Pi GRRL 2 using the brand new ~ hh 
Pi Zero W to create the ultimate retro handheld console... —— 
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YOUR PRRIS- 


Here's what you ll need to make the Pi GRRL Zero W 


Soldering iron 
Wire 

Heat shrink 
Glue 

Blu-Tack 

Wire strippers 
Hobby knife 
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3D-printed 
case 


The PiGRRL 2 case repurposed for our needs. 

It has some spaces for USB and Ethernet on 

a B+/2/3 board, but the Pi Zero will require 
extensions if you want to make use of the gaps. 


ol 


> magpi.cc/2l6zurq < 


The key to this project is the Pi Zero W. The wireless- 
enabled version of the Pi Zero is as powerful as the 

Pi Zero, yet saves a load of space thanks to the radio 
chip included in it, so no WiFi dongle is needed. It 
runs at 1GHz, which makes it powerful enough to run 
emulators of many eighties and nineties consoles. 


ro 


INN OAT 


‘i 


LS 


> magpi.cc/2lob5ky < 


This is actually a touchscreen, although 
we won’t be making use of it in that way. 
It fits neatly in the case and provides 

four extra buttons to use when playing 
games. You can also assign system and UI 
shortcuts to the buttons. 


~ 
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BUILD A HANDHELD GAMES CONSOLE 
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> magpi.cc/2lo5aFg < 


> magpi.cc/2lojfTb < 


This is one of the cool bits: we’re going 
to use this PowerBoost to actually 
charge a battery within the handheld. 
With the low power draw of the Pi and 
advancements in modern battery tech, 
you'll get a lot out of one charge. 


This switch allows you to turn the power 

on and off. It’s best to do the software | 
shutdown of RetroPie first before " 
switching the power off, though. 4 " 


| 


Microswitches 


> magpi.cc/2lo89g0i < 


The beauty of proper retro gaming is tactile 
controls. You’ll need ten 6mm switches, 

> magpi.cc/2lohN2U < and a couple of 12mm buttons. 

A wonderful innovation from Pimoroni, 
these GPIO headers require zero 
soldering and can be (carefully) 
hammered onto the empty 
pins of a Pi Zero. 


> magpi.cc/2lQzVmr < 


We squeezed the biggest battery into 
here that we possibly could. This way, 
it should last for hours and hours. 


A selection of 
screws to attach 
the parts to the 
case. This includes 
14x #4-40 and 

6x #2-56 3/8 


machine screws. 
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THE BIG BUILD 


—SSS=2 
PRINT THE 


What you need to know about 3D-printing the Pi GRRL 2 case 


Vy 
a 


| 
{ 
4% PIGRRL 2 - Raspberry Pi Game Console 


HOW TO PRINT 
YOUR 3D CASE 


pigrrl2-top.stl 


pigrrl2-bot.stl 
pitft-buttons.stl 
dpad2.stl 


Thing Apps Enabled 


action-btns.stl 


pause-start.stl 


shoulder-btns.stl Ss wl La Bs ES a. GET THE FILES AT 


shoulder-mount.stl 


>STEP-Ge2 : 
FIND A 3D Where 3D prints are made 


PR INT Ee R Find the right 3D printing service for your next project 


It can be tricky to find a good 3D printing service 

online, so unless you have access to a 3D printer, we 

highly recommend using 3DHubs.com. It lists local 3D enacne a 
printing services, along with an estimated completion siete tated umaround tins services ontin 

time and reviews. The files we downloaded also work USE 3DHUBS.COM 
with the service. -_ 


er 


tup Costs 


£2.99 
ihoulder-btns.stl £0.41 

1 
rigrri2-bot.stl £9.16 
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BUILD A HANDHELD GAMES CONSOLE 


YOUR F! 


Get your Pi Zero W ready to be made into a retro gaming treasure 


The configuration screen starts by asking 
about your current controller setup 


WELCOME 


= LEFT SHOULDER | = RIGHT SHOULDER | 


Coo D-PAD UP 


© 
x< 


@oo D-PAD LEFT 


-~< 
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@oD D-PAD DOWN 
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_— —— 
@x) 
S 
COCR © ae 


q@a@mp SELECT q@ap START 


a 
@OD| |@ 


») D-PAD RIGHT 


An oh en ah 
 - i- i» -, 


When you come back to reconfigure your buttons, refer to this handy guide 


SETTING UP WIRELESS 


Wireless connectivity on the new Pi Zero W is great, but the 
configuration method for wireless LAN on the RetroPie is very 
basic. You’1l need to know the name of your wireless network 
(SSID) along with the password, as it won’t be able to search for 
available networks. You can also import details by loading a .txt 
file onto the boot partition. 


Configure WiFi 
Current IP: 192.168.060.186 
Wireless ESSID: 


a ; 
2 Disconnect/Remove WiFi config POC RET 
3 Import wifi credentials from /boot/wifikeyfile.txt 


kK OK >F < Exit > < Help > 
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$ cd 

$ curl -O https://raw.githubusercontent. 
com/adafruit/Raspberry-Pi-Installer- 
Scripts/master/pitft-fbcp.sh 

$ sudo bash pitft-fbcp.sh 


$ cd 

$ curl -O https://raw.githubusercontent. 
com/adafruit/Raspberry-Pi-Installer- 
Scripts/master/retrogame.sh 

$ sudo bash retrogame.sh 
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THE BIG BUILD 


SUILD THE 


Follow along and build your retro handheld 


ADD THE 
BUTTONS 


Now it’s time to carefully solder 
the ten 6mm microswitches 
to the front of the board. 
Some helping hands would 
be good here. 
ee 
= eS ~ f— - 
— 


TURN ON oY! a 
THE BACKLIGHT ate i Ce + fe |) 


By default, the PiTFT doesn’t have its backlight ot fa " bg f, So. . oh et ‘ ee | | aby 
turned on. You need to take a craft knife and cut the | SS AN OLS eal |e 
circuit between the blocks in the #18 box that you 
can see circled in the picture. 


-STEP-@3 i (Ui Wi (8, iWi i Ue 


. ‘\ - ss ”~ 
~ ~ Sy ra hay ~ 

\O QQ] 
. — 
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BUILD A HANDHELD GAMES CONSOLE 


It’s a good idea to shorten 

the ribbon cable. 108mm is 
apparently the perfect size, but 
you can go a little longer. Once 
you’ve measured it, cut the cable. 


—) —) 


PREPARE 
FOR POWER 


To make all our soldering easier, we’ll dab some 
solder onto the spots where we need it for the 
moment. On the PowerBoost 1000C, add some 
solder to the positive and negative pins, and the 
EN and GND pins. Cut one of the legs off the power 
switch and put some solder on the other two. 
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ORIGIN 


Mitutoyo 


On / OFF ZERO / ABS 


-STEP-O5 


Using something like a pen or pin, you’1l need to push 
in the clip that holds the connector in place on the 
part you’re discarding. Very carefully remove the cable 
and install it at the end of your newly trimmed cable. 


st 1 80 BC 


afrul + ee 


3 Meal}! 
” ce Tre ha 
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THE BIG BUILD 
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-STEP-O 1 


Make sure the power switch will fit in the hole for it in the case - it’s on 
the side of the bottom part. You may need to file away the plastic a bit. 
Once that’s done, trim two short bits of wire to about 7cm long and solder 
one to each leg. Solder those to EN and GND - it doesn’t matter which way 
around they go. 


SHOULDER 
BUTTONS 


The shoulder buttons (the 12mm ones) need to 

be attached to the controller board much like the 
SOS SaaS OCC switch was connected to the power board. Clip two 

ae S legs off each and use a pair of pliers to flatten the 

remaining two. Solder wires to each pin (about 14cm 

long) and then solder the other end to the bumper 

pins on the controller board. Again, polarity doesn’t 

matter, but keep each one as a pair in the row. 


Wadatruit 


©.-Q PIGRRL 


-STEP-O9S 


WIRE IT 
ALL UP 


Now we can combine the power 4 
with the controller board, which | f —— 
will allow us to provide power sand ns 9 pesem OND Nash eg 8sn D4u> 

I =~ 
to the whole system. Solder two (Or \5 ology hots ye a} 9) 
wires (about 14cm long) to the . te, TTB cS, a eet = 
underside of the 5V and GND pins | bia = > Gig: — : 
on the controller board. The 5V | | aL, - Ger =) 

. oe f iM) : r ed 
wire should then be soldered to the i | mm 4 | J 
positive of the PowerBoost board, ®t fe 107 
with the GND to the negative qoglB riovepe ‘it 

g ; "= JBBBT 15005 wae 
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HAMMER 
THE HEADS 


It’s now a good idea to add the GPIO 
headers to the Pi Zero W. Gently 
hammer them in until they’re secure, 
and you’re done. 


TEST IT ALL OUT! 


->STEP-12 


You’ll now need to mount the back buttons and 
the PowerBoost. The rear buttons have a plate 
that keeps them in place, and Adafruit suggests 
using a little Blu-Tack to stick the switches in 
position. You’ll attach the power switch and then 
finally screw on the PowerBoost. Be careful with 
the wires that you’ve soldered on. 


a 
= aahhe) 


werboost 1908e 
m) jafruitst 


be 
= <=, () 


->STEP-13 


CLOSE IT UP 


Now you can finally close it up! Insert 
the battery and tape it down if need 
be, before screwing it shut. Make sure 
all the cables are safely inside the case 
before tightening it, though! 
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THE BIG BUILD 


Here's some of the amazing advantages 
of having the PiGRRL powered by Pi Zero W 


ssh pi@retropie 


___ Basic options for your PUTTY session 
Specty the destination you wart fo connect to 


Host Name for IP address) Port 


Defaut Settings: | (bead) 
(Seve 

| | Oere_} 

Close window on ext 

Awaye ©) Never @& Only on clean edt 
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Version: 4.0 . 
Last Commit: 26 minutes ago (8caed9) 


| Meeasic install 
Update all installed packages 
Manage packages 

Configuration / tools 

Update RetroPie-Setup script 
Uninstall RetroPie 

Perform reboot 


2xuavec 


K OK > < Exit > < Help > 


UPDATING 
RETROPIE 


You can update RetroPie from the handheld itself 
or via SSH in the command line. The keyboard 
might be better suited for this, so if you’re by your 
computer it wouldn’t hurt to use it instead. 

From the handheld, you need to go to the 
RetroPie menu in EmulationStation and activate 
the setup script. From the terminal (if you’ve 
SSHed in), you can use the following command: 


sudo ~/RetroPie-Setup/retropie_ setup.sh 


From here, look for the ‘Update All Installed 
Packages’ option. There are many options here 
that you can select from, including managing the 
individual packages in case you want to remove 
or add any. To update, you can select the option 
‘Update all installed packages’ (which will also 


update the RetroPie-Setup script as well) or 

you can go to ‘Manage packages’ and update the 
packages individually. This could be useful if any 
packages have some problems updating, or if you 
want to do the essential updates before running 
out the house. 
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Organize v Network and Sharing Center View remote printers 


Ea Videos “ 
bios 
Share 


2@ Homegroup 


configs 


Share 


(& Computer 
& Local Disk (C:) 


© Network 
pM 192.168.0.107 
| CAPTAIN_BLINKY 
"™ RETROPIE 


3 items 
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UPLOADING 
FILES 


If you want to upload ROMs to the handheld, 
you can do so with the Pi Zero W’s wireless 
connection. Otherwise, you’d have to manually 
load them onto the SD card, which would 
require dismantling the console to get to the 

Pi Zero — not particularly easy or practical 

to do. Luckily, RetroPie includes Samba and 
SFTP, which allow you to transfer the files over 
the network. 

For Samba it’s nice and easy: when your 
handheld is connected to your network, you 
can go to your main computer and find it on 
the network shares as \\RETROPIE. Here you 
can upload any necessary extra files to the 
handheld with minimal hassle. 

For SFTP you’ll have to make use of 
special software. For Windows, the 
RetroPie team recommend WinSCP 
(magpi.cc/2ICwRhz); for Mac, you can try 
Cyberduck (magpi.cc/21Cwjs9). 

Once booted up, you can use the same SSH 
settings as we used for PuTTY. You can then 
drop the files into the corresponding folder in 
the roms directory. 


System: snes 

Emulator: Ilr-snes3x-next 
Video Mode: 

ROM: Mask, The (U) 


Wselect default emulator for snes (1r-snes3x-next) 

2 Select emulator for rom () 

4 Select default video mode for Ir-snes3x-next () 

5S Select video mode for Ir-snes9x-next + rom () 

8 Select RetroArch render res for Ir-snes9x-next (640 
3 Edit custom Retroarch config for this rom 

x Launch 

G@ Exit (without launching) 

2 Launch with netplay enabled 
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CAUTION! |; 
— , 
PIRATING VIDEOGAMES IS BAD, 
NOT TO MENTION ILLEGAL! 


——io) 


feature 


= re 
== KP gas Se 
od 
a7 


Port number: 


User name: 


Don't use illegally downloaded 
content on your PiGRRL. 


| Cancel 


Gi New Site Session 

GI) root@192. 168.0. 110 File protocol: 
SFTP w 
Host name: 
RETROPIE 


225 


Password: 


| Advanced... M 


ose Help 
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THE 


RUIZ BROTHERS 


We talk to the original creators behind the Pi GRRL and many other amazing Adafruit projects 
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wo of the superstars of the maker scene are Noé Ruiz 

and Pedro Ruiz, otherwise known as the Ruiz Brothers. 

They’ve done many amazing projects for Adafruit, 
including a lot of 3D printing and wearables, which always go 
down well with the community. So it’s surprising to hear they’ve 
only been in the maker scene for about five years. 

“My brother and I purchased our first 3D printer in 2012 and 
quickly started using it in our work,” Noé tells us. “While looking 
for a way to integrate lighting into our 3D-printed designs, we 
discovered Adafruit and the Arduino platform. We built some 
projects using their parts and came up with some unique ideas. 
We went on Adafruit’s weekly live show-and-tell show, and the 
rest is history.” 

What started off as a load of cool hacks that added LEDs to 
existing products or enabled you to create great light-up projects 
quickly evolved into doing more. Part of this was to do with the 


introduction of the Raspberry Pi. 
“Our first project with the Raspberry Pi was the DIY Wearable Pi 
with Near-Eye Video Glasses,” explains Noé. “We were interested 
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BUILD AN AWESOME RETRO HANDHELD 


FROM THE 
RUIZ BROTHERS 


Other amazing things you can find 
by Noe and Pedro 


Plies 


= 


— 


\ 


it 


an 
3 


Cn = 
» re 


in Google Glass and thought we’d make a DIY version with the 
Raspberry Pi. We hacked apart a pair of video glasses, and designed 
a custom 3D-printed housing for the display and driver. It was a fun 
experiment and this is how we learned about the Raspberry Pi.” 
Things escalated even further when the brothers made the 
original PiGRRL. Originally an idea from Limor Fried, founder of 
Adafruit and ‘Ladyada’ herself, the idea was to improve upon her 
earlier Game Grrl project but this time use a custom 3D-printed 
enclosure. It was their biggest project to date, so they were 
extremely happy to see that it had such a positive reaction. 

The PiGRRL projects have since become the Brothers’ favourites 
to work on, according to Noé. 

“T think it’s become a classic Raspberry Pi project because it 
looks like an iconic device that offers lots of playtime. People love 
to play games, and being able to build your own gaming console is 
super-rewarding. Every year we create a new version with better 


hardware, and change the form factor to try different designs. So 
many folks have built one and it’s really awesome to see parents 
building them with their kids.” 

What’s in the future for the PiGRRL and the Ruiz Brothers? Well, 
PiGRRL 3 is happening this year with a “bigger screen and better 
audio”, and should be a much quicker build. Watch this space! 
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Projects 


» The display 
resolution is 
12864 


» Currently, it 
costs around 
$50 in parts 


» It connects to 
a 2G network 
(a 3G model 
is planned) 


» The OS is 
based on 
Raspbian Linux 


» There are plans 
to crowdfund 
the project 
as a kit 


A SIM800 GPS module 
and antenna are used to 
connect to the mobile 
phone network 


A small LCD screen 


displays the operating 
system (based on 
Raspbian Linux) 


Buttons are connected 
to the PCB, and an 
ATMega328P module 
is used to convert 
button pushes into 
phone commands 
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PHONE 


Turning a Pi Zero 
into a mobile phone 


eroPhone is an open- 

source project to create 

a mobile phone kit for 
the PipZero: 

Owners of ZeroPhone will be 
able to make calls and send text 
messages. It will also have basic 
apps such as an alarm clock, 
calendar, calculator, web browser, 
and music player. 

Behind the project is Arsenijs 
Picugins, an 18-year-old student 
from Riga, Latvia. He now has a 
team of people helping him. 

“It’s open-source, Linux- 
powered, and you can make one 
yourself for $50,” he says. 

Arsenijs has been studying 
mobile phones for a couple 
of years. He hopes to sella 
commercial kit, while keeping 
it all open-source for people to 
build themselves. 

“The phone hardware is at 
‘alpha’ stage,” he tells us. 
Arsenijs has designed the 
first revision of PCBs (printed 
circuit boards) and is developing 
the software. 

“The next revision will be 
ready-to-assemble,” reveals 
Arsenijs. Raspbian is being 
customised to run on the 
ZeroPhone. “It can be tailored 
to suit our purpose very easily,” 
explains Arsenijs. 

“Tve currently got a framework 
I’m using for headless Pi 
configuration,” he continues. 
Python is being used to create 
a user interface (UI). An 
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Above The components and software are under development, 


ZEROPHONE 


Projects 


DESIGNING A PI 
ZERO PHONE KIT 


SExiM,- TY eocees 
> Wa 


and a kit will be made available when it's ready 


earlier project called pyLCl 
(magpi.cc/2kjv20A) forms the 
base of the interface. 

Developed by Arsenijs in 
2016, pyLCl is a Linux control 
interface. It enables you to 
control and configure your Pi with 
SSH, networking, or using an 
HDMI monitor. 

“T developed it because that’s 
what I needed to improve 
my Raspberry Pi tinkering 
and development workflow,” 
recalls Arsenjjs. 

“Developing a good UI is one of 
the primary goals of this project,” 
Arsenijs adds. 


I developed 1t because that’s 


>STEP-0O1 


“That’s what I’m focused on, and 
that means extensively testing 
the hardware I’ve got now, to find 
everything that has to be fixed.” 

Once v1.0 is ready, he will 
publish the design files and 
instructions, so people will be 
able to start assembling their 
phones if they wish. He’ll then 
prepare a crowdfunding campaign 
to fund a manufacturing run and 
software development. 

“It’s the only phone you can 
assemble by getting all the parts 
yourself,” claims Arsenijs. It 
doesn’t use any rare parts or fine- 
pitch soldering. “You can even 


>STEP-02 


what I needed to Improve my 
Raspberry Pi tinkering 


Because Linux is the base, it can 
support a range of programming 
languages. Arsenijs expects 
“original ideas” for apps. He will 
be working on productivity and 
healthcare apps. 

The open-source software 
approach is “likely to be secure 
and not privacy-invading,” says 
Arsenijs. You can disable features 
you don’t like, and it doesn’t 
depend on any cloud services. You 
will be able to install firewall, 12P, 
and TOR nodes, as well as secure 
messenger Services. 

Arsenijs’s current goal is to 
make the v1.0 PCB revision. 
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breadboard this phone if you’re 
dedicated enough. 

“For me, this project is a 
huge undertaking that, if done 
right, will influence the way we 
perceive mobile phones,” remarks 
Arsenijs. He explains that it will 
help solve privacy and security 
concerns, as well as allow us to 
develop better open-source GSM 
technology. It will also help power 
mobile phone hacks. 

“Besides, this is an open-source 
Linux- powered phone you can 
independently assemble for less 
than $50,” observes Arsenijs. 
“That’s pretty cool.” 


>STEP-03 
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Projects 


TRACKING 
MOUNT 


For Mike Hamende, making something is far more exciting and rewarding than 


logging into an online store, as his Pi- powered tracking telescope mount proves 


» Mike has 
no previous 
experience of 
coding Python 


» The tracking 
mount is set to 
find 800 preset 
locations 


>» The mount runs 
ona battery, 
making it 
portable 


» It cost 


$350-$400 
to build 


» See a video 
of the mount 
working here: 
magpi.cc/ 
2l1GLgWf 


f you search for Mike 

Hamende’s user name 

‘8PumpkinDonuts’ online, 
you’ ll soon realise that he’s quite 
the craftsman. From a suspended 
lounger for his fiancée, toa 
wristwatch built completely from 
scratch, Mike is a true maker. So 
it’s really no surprise that he’d 
eventually build a Raspberry Pi 
project that we could sink our teeth 
into. Despite his lack of previous 
Python knowledge, and ignoring 
the fact he could easily purchase 
what he’d decided to build, Mike 
produced a tracking telescope 
mount for his 8” Orion reflector. 

“This is definitely the most 
involved project I’ve ever 
completed,” Mike tells us. “I’m 
aware there are mounts I| could 
have bought to accomplish the 
same thing, but, while astronomy 
is a hobby of mine, building things 
is what I’m really into.” 
Mike used two Nema 17 stepper 

motors, powered by a Raspberry 
Pi 3, to angle the mount. For 
the frame, he used 3x3 T-slot 
aluminium, utilising his CNC 
mill, CNC router, and CNC lathe 
to cut further pieces of aluminium , 
for the mount. ese" a 


Mike 3D-printed several 
parts of the mount 
when he was unable to 
find the correct pieces 


The Raspberry 

Pi sits beneath a 
touchscreen, housed 
in a 3D-printed case 


~ 
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The mount runs ona 
12V/12AH SLA battery 
hooked to the back of 
the frame 
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Two turntables with 60mm 
thrust ball bearings act as the basis 
for the motion mechanics, cut 
from 1/2’ thick aluminium. Mike 
then had to build his own drive 
pulleys using 3D-printed parts and 
fibreglass flanges. He amended 
technical documents he’d found 
online, removing teeth, until the 
pulley fitted perfectly within the 
build. From here, he also went on 
to print, rout, and fit all the pieces 
needed for the mount and frame 


ce {GX} 19.6} 


The red tint to the screen 
helps to better protect 
Mike's night vision when 
realigning to new objects 


to control the stepper motors and 
linear acceleration, so he was still 
faced with the challenge of quickly 
learning enough Python to see 
him through. 

Once he’d cleared up his 
prototype breadboard and 
soldered the boards into 
place, Mike fitted the Pi with a 
touchscreen. The screen enables 
him to select one of 800 preset 
targets for the telescope to focus 
on. If he wants to view any other 


My hobby 1s making things and 
I've been doing 1t since I was old 
enough to hold a screwdriver 


before turning to a less-familiar 
subject: the Raspberry Pi. 

Mike originally created a script 
that would position the telescope 
to align with celestial objects by 
way of information from the US 
Naval Observatory. However, 
upon completing the code, he 
discovered PyEphem, a Python 
package that offered a much larger 
scope for celestial exploration. 
Though he had the PyEphem 
code, he couldn’t find anything 
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object, he simply uses a small 
wireless keyboard to enter the 
chosen coordinates manually. 

Mike went to school to study 
mechanical engineering, though 
he attributes much of his skill 
to being a hobbyist. “My hobby 
is making things and I’ve been 
doing it since | was old enough 
to hold a screwdriver.” He even 
converted his home lathe and 
router to be CNC, and built his 
own 3D printer too. 


Projects 
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DANIEL FERNANDEZ 


A chemist, blogger, and consultant 
with a life-long passion for 
electronics and DIY projects. 
github.com/danielfppps 


A simple case: you can 3D-print 
one or get a pre-existing case 
that supports a 3.5° screen 


It's a very neat setup: a Pi, 
a screen, and a Bluetooth 
heartbeat monitor 


— Data is live-plotted but can 
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be reset at any time, with 
the old data saved to file 


MONITOR 


The Raspberry Pi is increasingly being used in health applications — 
here’s how one maker made his own DIY Pi health device 


It took two days 
for Daniel to 
develop the 
software 


Daniel wants to 
make an open- 
source voice 
assistant 


If you use the 
project, make 


sure the code 
La he current surge of smart Daniel Fernandez has decided to then save the data so that you can 
i watches, however long create his own heartbeat monitor work with it later. Furthermore, I 
manner it lasts, probably owes with help from a Raspberry Pi. wanted some flexibility in how the 
the Raspberry something to the activity trackers “T have always liked to monitor data was plotted and how often the 
Pi, using it that are synonymous with anyone my heartbeat while I run on the heartbeat was updated, and to be 
ene trying to keep track of their fitness. treadmill,” Daniel tells us. “There able to retrieve the data from the 
several projects 


The case is to 


These devices track the user’s 
heartbeat and use it to calculate 


is Simply no cheap, commercial 
solution that did everything I 


device in an easy-to-process format 
like CSV.” 


protect the Pi } } } ; ; ; : 
from sweat and things like periods of rest, calories wanted: to plot the results in a graph So began Daniel’s build. He 
spilt water burnt, and more. You can tell a that’s easy to monitor, so that you selected the Raspberry Pi 3 as it 


lot of things from a heartbeat, so 
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can look at them while you run, and 


was a fully fledged computer with 
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You only need four items to make the monitor - how many projects are this simple? 


built-in Bluetooth that could fit 
on his treadmill. He coupled it 
with a Polar H7 heart sensor anda 
3.5 screen, and 3D-printed a little 
case to fit it all in. 

“It’s not very difficult to build 
as most of the project is based 
on software,” explains Daniel. 
“Tf you have the sensor, screen, 
and software, you could have it 


“So far, the Raspberry Pi has 
always worked correctly with my 
heartbeat sensor,” Daniel says. 
“The program has always provided 
smooth plots and a very responsive 
display of my real-time heartbeat. 
I have been able to save my run 
data files and perform some more 
extensive mathematical analysis 
to better understand how my heart 


It you have the sensor, screen, 
and software, you could have it 
working in less than a few hours 


working in less than a few hours. 
I have made the software open 
source and available via a GitHub 
repository [magpi.cc/2kBjoaM].” 
He’s been successfully using it 
for its intended purpose, having run 
20 miles with it since he finished 
UNS DONEC, 


reacts to changes in intensity, 
cadence, inclination, and so on. 

“T would want to include some 
functionality to save my heartbeat 
files to my Dropbox and even have 
the option to share the data on 
my social media accounts when | 
finish each run. I was also thinking 
about connecting the treadmill’s 
control panel to the Raspberry Pi 


SERRRERRERESRERE 
AtATATLISEL SL 


so that the treadmill could adjust 
_ intensity automatically to match 
| atarget heartbeat.” [sis 

Other heartbeat sensors that ass — 

_ follow the same standard as the ieee 
Polar H7 should work with the 
— project if you decide to make 
EEE your own. Maybe it’s a good 
excuse to keep up with your New 
Year’s resolution? 


<5 


SESRRESHRRESRRESRE ESS 
PREPITITE ILL aL 
+SELSESES 22208 t4 


The Pi waits patiently until it 
gets data from the heartbeat monitor 
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of coding 6 
creating 


raspberrypi.org/magpl 


£12.99 


200 pages of 


THE Official ‘qamiade 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


Amazing hacking and making projects 
from the creators of MagPi magazine 
Inside: 

How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 


Expert reviews and buying advice 


Available 
ne magpi.cc/MagPiStore 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the | GET IT ON 
“ App Store >» Google Play 
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Build your home theatre media centre with a Raspberry Pi and OSMC 


uilding a media centre, or HIPC (home 
theatre PC) is one of the most rewarding 
projects a newcomer can complete. 

It’s easy to turn a Raspberry Pi into an HTPC, and 
you can quickly hook it up to your television. 

Using an HTPC, you can play video and music files, 
and stream video and audio from online services. And 
unlike proprietary systems, such as Apple TV and 
Google Chromecast, you can use it to play just about 
any media format. 

You can add streaming services to your HTPC, such 
as BBC iPlayer and Soma radio stations. These enable 
you to play media directly from the internet. 

There are several pieces of software available for 
setting up an HTPC. Two options you’ ll find on the 
Raspberry Pi Foundation’s Downloads page are OSMC 
and LibreELEC. Both are similar and run a media 
player called Kodi. 

In this guide, we’re going to opt for OSMC. It’s a 
free and open-source media centre built on top of 
Debian, and is reliable and easy to use. 

Setting up OSMC on a Raspberry Pi is 
a Straightforward and rewarding project. 

Let’s get started. 


Etcher 


SELECT mace SELECT ORIVE FLASH MACE 


Se 


OSMC_TGT_...24,img.gz @ 


“METCHER 


>) Videos 


a Nasa IV HD 


> Rete of the Keng fe Oragen : Free Down oed & Streaming: internet Acchive - Moris Firefox 


Starter 


9 
TSAb HON @ 
Ly * 
fe 


Pe] | ISS Live Stream 
“a 


Return of the Kung Fu Dragon 


Educational Channel HD 


<< COWL OLD OPTIONS 


| Media Channel HD 


ISS HD Earth Viewing - ustream 


ISS HD Earth Viewing - urthecast HD 


rh 


Return_of_the Kung _Fu_Dragon.ogv 


Queue after current 


Queue 


Play 


Back up the files on a Raspberry Pi so you can quickly restore your files 


Raspberry Pi 
SD card 


! 


, Flash drive | ; 1g ie | 1a 


Adding a password to your backup can secure the 
files stored remotely (or on an external drive) 


Deja Dup is a popular program Files backed up using Deja Dup are 
used to schedule backups restored using the same program 


eee 


| LT) - « 


: Require Password? =~ 


Last backup was toda’. 
f=9 ~Youcan restore the entire backup with the Restore... button or use Files to either 
revert individual files o1 restore missing ones. 


No backup scheduled. 
You should enable automatic backups or use the Back Up Now-. button to start one now. 


Back Up Now. 


© Allow restoring without a password 


@ Password-protect your backup 
You will need your password to restore your files. 
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Se Win32 Disk Imager 


You can clone you 
dd on a Mac or Linux, and Win32 D 
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+ No recent backups. 
GR You may use the Restore_ bution to beowse for existing backes. 


|_Pesore. | —s 


You shoud enalie automatic backups or use the Back Up Now_ bution to siart one now 
| Back Up now. | 


Above: =| \== 
can be restored 
individually, or 


The speaker will 


do the talking 
for Alexa 


The USB microphone 
will do the listening 
for Alexa 


The GoPiGo will 
do the walking 
for Alexa 


HOW TO MAKE AN 
ALEXA-POWERED 


gROBOT 


2gommaV Build an Amazon Alexa-controlled robot using the Raspberry Pi, 
ieee allowing you to operate it with just your voice 


Developer 
account 


Raspberry Pi 3 


The GoPiGo 
magpi.cc/ 
2hA8f6i 


Raspbian for 
Xe) oe) ks 
magpli.cc/ 
2kixPxB 


Speaker for the 
Raspberry Pi 
magpi.cc/ 
2hAgCi7 


inally, a Raspberry Pi robot to do your 
bidding, controlled only by the sound of 
your voice! Amazon Alexa software can be 
put on the Raspberry Pi robot, the GoPiGo. In this 
project, we’ll create an Alexa-based robot that will 
respond to voice commands, as well as answer your 
questions. You can ask Alexabot “How hot is it in 
Dubaic” or “What’s the weather like in Londone”. 
What makes Alexabot really interesting is that you 
can order it around with your voice, using the Alexa 
Voice Service (AVS). 

The first step towards robot world domination 
and building our Amazon Alexa-controlled robot 
is to set up AlexaPi. 


A free IFTTT 
account 
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MA Make a web request 


This action will make a web request to a 
publicly accessible URL. NOTE: Requests 
may be rate limited. 


URL 


http://580b2886.us.ngrok.io/forw 
ard 


Surround any text with "<<<" + Ingredient 
and ">>>" to escape the content 
Method 


GET 


The method of the request e.g. GET, POST, 
DELETE 


Content Type (optional) 


text/plain 


Optional 


Body (optional) 


forward 


Surround any text with "<<<" + Ingredient 
and ">>>" to escape the content 


Fig 1 An example of how to build your own command 


There are a few tutorials on how to turn your 
Raspberry Pi into an Amazon Echo using Amazon 
Alexa. However, AlexaPi (magpi.cc/2kiyOxO) is the 
easiest way to get Amazon Alexa on your Raspberry 
Pi. The project has prepared everything to set up 
Alexa Voice Services on your Pi in a streamlined 
and simple manner. The hardest part is setting up 
your Amazon Developer account and gathering your 
credentials (and really, that’s not that hard!). 

At this point, with your speaker and your 
microphone plugged into your Pi, you should be able 
to run Alexa on your GoPiGo, just as you would on 
an Amazon Echo. Ask it for a news update: “Alexa, 
what’s the news°” 
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Tutorial 


qllexabot.py 


from flask import Flask 
import gopigo 
import time 


DOWNLOAD: 


magpi.cc/ 2kiFlZz 


app = Flask(__name_ ) 
set oute('/') 
det Q: 


Neetiea 


we ) 
vd() # Send the GoPiGo Forward 
Baas # for 1 second 


Bese # then stop the GoPiGo 
return 
@app.route( ) 
def (): 
print( ) 
gopigo.bwd() # Send the GoPiGo Backward 
time.sleep(1) # for 1 second 
gopigo.stop() # then stop the GoPiGo. 
Pevtiien 
@app.route( ) 
print ( ) 
g0p1g0. 1ereC) 
time.sleep(1) 
gopigo. tne 
return 
@app.route( ) 
def os ) : 
print( ) 
eons right() 
time. eee 
gopigo.stop 
Fetuinn 
@app. route ( ) 
def (): 
print( ) 


for each in range 
gopigo.right() 
time.sleep 
B0p1g0. ] 
time. 
papthe | d 
time.sleep(@.25) 

gopigo.stop() 

return 


(O55) 


print ( ) 


return 


if _name_ == : 
app.ru Er ienues True, eee ) 
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Fig 2 Your ngrok 
readout should 
look a bit like this 


TRIGGER 
WORDS 


RUNNING 
THE FLASK 


SERVER 


Next, we’ll set up IFTTT. If This Then That (IFTTT) 
is a service that lets us connect different parts of 
the web together. In our case, IFTTT helps us couple 
Alexa together with the Raspberry Pi. IFTTT lets us 
bridge the AlexaPi responses back to the Raspberry 
Pi. First, you’ll need to set up an IFTTT account. 
(ifttt.com/join). Again, this is free. 

Next, you’ll need to add the IFTTT service to your 
AlexaPi. You can do this by first installing the Alexa 
app on your phone or tablet (magpi.cc/2kyIJho); it’s 
available for iOS, Android, and Fire OS. With your 
phone on the same network as your Pi, connect to 
your AlexaPi and add the IFTTT service. 

Next, in IFTTT, we will need an applet for each 
command we want to send to the GoPiGo. First, 
connect Amazon Alexa to your IFTTT account 
(magpi.cc/2kizD9X). Then we’1l do the following to 
create an applet that will handle a single command: 


J). Create an IFTTT applet (magpi.cc/2jTYYn2) 
for our first command. We will create 
an Alexa applet. 


Specify the command. Say “Backward”, 


We'll use the action service, Maker. 


The URL is either your provided ngrok URL or 
your custom domain. We will find this in our 
next step, but for now we can enter ngrok.io. 


Click ‘Create Action’ and then ‘Finish’. 
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Fig 1 shows how this is done in more detail. We 
will need to do this for all the moves you want 
your Amazon Alexa-controlled robot to make! In 
Our project, we made seven: one each for Forward, 
Backward, Left, Stop, Right, Dance, and Coffee. 

Next, we’ll connect to the ngrok service. We will 
have IFTTT contact a server on the Pi, but the tricky 
part will be setting up a server on the Pi that’s visible 
to the world outside our local wireless network. For 
this, you can use ngrok (ngrok.com), a service that 
allows you to connect to your Raspberry Pi through 


A robot that will 
respond to voice 
commands 


any network. IFTTT needs an internet-based URL 
to contact, so we’ll use ngrok to make our server 
accessible to the outside world. 

First, set up an account with ngrok. You can get 
away with a free account, but it will be much easier to 
set up Alexabot with a paid account. A paid account 
will allow you to set up named servers, rather than 
ngrok’s randomly assigned server. 

Next, install ngrok on your Raspberry Pi using the 
directions here: ngrok.com/download. 

This should install all the software. You will next 
need to get your token, which will authorise your 
Raspberry Pi to ngrok. If you log into your account you 
will see step 2, with your token already populated. It 
should start with ./ngrok authtoken. Copy the 
command, and paste it into your command line. 


Test out ngrok 


You can type the following into the command line: 
./ngrok http 8@ 
You should then see a server start up, as shown in 


Fig 2. When an IP address appears, try typing that IP 
address into your browser. You should see your default 
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server on Port 80 come up. We will start our server 
with the following command: 


./ngrok http -subdomain=dexterindustries 50@Q@ 


...where ‘dexterindustries’ is a reserved domain set 
up with our basic account on ngrok. If you go with the 
free account, you’1l now need to go back and re-enter 
the domain name that ngrok gave your Pi into each of 
your IFTTT commands. 


GoPiGo 


Set up the Flask server 
The final step in getting our Amazon Alexa-controlled 
robot working is setting up the Flask server on 
the Raspberry Pi. 

We’ll set up a Flask server in Python to listen to 
IFTTT. To install Flask on the Raspberry Pi, enter the 
following into your command line: 


( ) amazon alexa 


AlexaPi 


Frit 


iftisthenthat 


sudo pip install flask 


You can try running the Flask server we’ve 
provided in our GitHub code and see what happens: 


python alexabot-flask-app.py 


You should see the Flask server start! 

To get an idea of how the code works on the Flask 
server, you can type the following in your web browser: 
http://alexabot.ngrok.io/forward. You should get this 
response in your browser: ‘Alexabot moved forward)’. 

This illustrates how the Forward command works; 
each command will work this way, with its own 
directory and custom code for moving the GoPiGo. 

Now, with all the services set up, we should be able 
to say acommand like “Alexa trigger forward”; Alexa 
will alert IFTTT, which will send an HTTP message 
through ngrok back to our GoPiGo and post to the 
web server running in Flask. The Flask program will 
command the GoPiGo to move forward. 

The quick-start method to get running with 
Alexabot is to first start AlexaPi: 


sudo python /opt/AlexaPi/src/main.py 
Next, start ngrok in a separate window: 


sudo ~/ngrok/ngrok http 
-subdomain=dexterindustries -log=stdout 
5000 > log.txt & 


Flask 


web development, 


Finally, start the Flask server: AN 
nS one drop at a time 


sudo python alexabot-flask-app. py 


The flow of information 
for getting the 
Alexabot to respond to 
your command 


Start talking! Remember, your commands need to 
start with “Alexa trigger...” and then the command 
you want the robot to carry out. 
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) = @ &) WB pi@caspbenypi: ~ 


“input c- /home/pi- G 


2 e}|™ 
File Edit Sea ew 0 ner ect Build Tools Help 
~ &@ ae x 3 @ ~ bs 2@ g » 
Syn > | inpute x 
ae aye : 
ed 2 | 
ome 3 void main (void 
4 of 
5 char input(256], name[ 256]; 
6 we er, r 
7 \ 
8 printf ("wheat is you ame 
9 fgets (input, 256, stdin); 
10 sscanf (input, “\o', name); 
et 
i2 printf ("ie L! 
3s while (1) 
1468 { 
I | fgets (input, 256, stdin); 
16 if (sscanf (input. “%("| Gage) 22 1) 
17 print "thst was ry Tihs reg e 
18 CO 
Oo | 
2 printf ("ws 
a *) 
Gta 
PUES 14:36:03: File Mome/piinput.c opened 
Compiler) 14:37:20: Fie momeypuing od 


14:37:4 
Messages : 


SCANF 


Just like sscanf, 
scanf returns 
an integer 
indicating how 
many values 

it successfully 
read, which 
you can use 

to check for 
errors. One 
problem is 
that scanf 
only removes 
matched 
values from the 
input buffer, 
so if a scanf 
fails to match 
anything, 
what the user 
typed will be 
read again on 
the next call 
to scanf. It 
really is easier 
to use fgets 
and sscanf! 


GET THE 
NUMBER 
RIGHT 


Remember 
that the first 
item in the argv 
array - argvio] 
- isthe name 
of the program 
itself, not the 
first parameter. 
The actual 
parameters 
start at argvi1l. 
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fgets is the library 
function to read text 
from an input stream 


stdin is the input 
stream associated 
with the terminal 


AN INTRODUCTION TO C 


USER INPUT 


Reading and interpreting input from the user 


n the previous instalments, we’ve looked at 
how to print program output to the terminal, 
but in order to interact with the user, this 
needs to be a two-way process. This instalment looks 
at how we can read and interpret input that the user 
enters in the terminal. 

The printf is the standard way of writing formatted 
text output from a program, but how can we read what 
the user types ine 

In the last instalment, we looked at the sscanf 
function, which reads values from a string. There’s 
an equivalent function called scanf, which reads 
values typed in by the user: 


. & 3 £a g >» 
Symbols |> | input 
hr S y 

ou 3 int ma int argc, ch org 
4 
5 int argl, arg2 
6 
7 if roc 
8 { 
> sscant 


Above The argc and argv arguments to the main function can 
be used to access parameters typed on the command line 
when the program is run 
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#include <stdio.h> 


void main (void) 


{ 
char input[ 256]; 
int age; 
printf ("What is your name, user?\n"); 
scanf ("%s", input); 
printf ("How old are you, %s?\n", input) ; 
scanf ("%d", &age); 
printf ("%s, you're %d?\n", input, age); 
} 


scanf works exactly like sscanf, but has one fewer 
argument, as it reads from the keyboard rather than 
from a String. 

However, it’s not the best way of getting input, as 
it relies on the user doing what you expect, and this 
doesn’t always happen! (For example, in the code 
above, if the user types in 257 characters when asked 
for their name, they will overflow the space allocated 
for the input string, and bad things may happen...) 


A better way 
A better approach is to read each line the user enters 
into a buffer string, and then use sscanf to read 
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values from that string. The C library function fgets 
is useful for this. See the following example: 


#include <stdio.h> 


void main (void) 

{ 
char input[256], name[256]; 
int age; 


printf ("What is your name, user?\n"); 
fgets (input, 256, stdin); 
sscanf (input, "%s", name); 


printf ("How old are you, %s?\n", name); 
while (1) 
{ 
fgets (input, 256, stdin); 
if (sscanf (input, "%d", &age) == 1) 
break; 
printf ("Not an age, try again!\n"); 
} 


printf ("%s, you're %d?\n", input, age); 
} 


fgets takes three arguments. The first is the buffer 
into which it should store the input. The second is 
the maximum number of bytes it will write into that 
buffer, which is useful to prevent overflow situations 
like that mentioned above. The third tells it where to 
read from — in this case, stdin (short for ‘standard 
input’) is the keyboard. 

When we ask the user for input, we use fgets to 
read up to 256 characters of whatever they type (up 
to the point at which they press the ENTER key), and 
we then use sscanf to interpret it. When asking for 
the user’s age, we use the value returned by sscanf 
to check that the user has entered what you expect, 
and loop until they give a valid answer. This makes 
it easier to handle the cases where the user types 
something unexpected! 


Reading parameters 

There’s another way to get input to your program, 
which is to supply it as a parameter when you Start the 
program from the command line. We’ve always shown 
the main function as 


void main (void) 


This works, as you’ve seen, but it isn’t strictly 
correct. The strict definition of main looks like this: 


int main (int argc, char *argv[ ]) 


But if you’d seen that in instalment 1, you’d have 
run a mile, wouldn’t you: 


raspberrypi.org/magpi 


AN INTRODUCTION TO C 


main returns an integer — this is a success or failure 
code which some operating systems can use for 
processing in a shell script or the like. Traditionally, 
if a program succeeds, main returns 0; if it fails, it 
returns a non~zero error code. For programs that run 
on their own, you don’t need to worry about it! 

argc is the number of parameters given on the 
command line after the program name. This number 
includes the program name itself, so it’s always 1 or 
more; if parameters are provided, it will be 2 or more. 

char *argv[ ] is an array of strings, and each string 
is one of the parameters. 

It’s probably easier to understand that in practice, 
so here’s an example: 


#include <stdio.h> 


int main (int argc, char *argv[ ]) 
{ 

int param = Q; 

while (param < argc) 


{ 
printf ("%d is %s\n", param, argv[ param] ) ; 
param++; 

} 

return Q; 


} 


Try running this as before, just by typing its name. 
Then try typing other things after the name on the 
command line and see what it prints. 

Here’s an example of a simple calculator written 
using parameters: 


#include <stdio.h> 


int main (int argc, char *argv[ ]) 
{ 
int arg1, arg2; 
if (argc == 4) 
{ 
sscanf (argv[1], "%d", &arg1); 
sscanf (argv[3], "%d", &arg2); 
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LEARN T0 
CODE WITH C 
BOOK 


Want to learn 
more C? You 
can find the 
entire series 
and more in 
the Learn to 
Code with C 
Essentials 
book, available 
digitally and 
in print now 
at magpi.cc/ 
learn-c-book 


Magri 
LEARN 


STDIN AND 
STDOUT 


We talk about 
‘stdin’ in this 
article, which is 
the ‘standard 
input’ stream 

— what the 
user types at 
the console. 
You may 
sometimes see 
references to 
‘stdout’, which 
is the ‘standard 
output’ stream 
— as you might 
expect, this is 
output which 

is printed to 
the console, 
usually 

via printf. 


if (*argv[2] == '+') printf ("%d\n", arg1 + arg2); 
if (*argv[2] == '-') printf ("%d\n", argi1 - arg2); 
if (*argv[2] == 'x') printf ("%d\n", argi1 * arg2); 
if (*argv[2] == '/') printf ("%d\n", argi / arg2); 
} 
return 0; 


} 


argv[2] is the second parameter; this is a string, 
but we’re only interested in the first character, so we 
use *argv[2] to get this. 

Make sure you separate the arguments from the 
operator with spaces so they are identified as separate 
parameters — <progname> 2 + 2 rather than 
<progname> 2+2. 
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Tutorial WALKTHROUGH 


GERMANO CESARI 


CEO and Glise lead developer 
at twistednormal ltd. Writes 
code for a living, smokes ribs 
for pleasure. 
twistednormal.com 


MODEL A SQUI 
Wilh 


How to get started with 3D modelling and turn your Raspberry Pi 


> Raspbian 


> Glise 
magpi.cc/ 
2kqaliq 


> Experimental 
GL drivers 
magpi.cc/ 
2knRTvS 


> Three-button 
mouse 


into a personal graphic workstation 


uring the last few years, 3D applications 

have been behind many achievements 

in computational and video hardware, 
addressing whole new branches of computer graphics. 
Once known as 3D modelling applications, these 
packages are now best described as fully fledged 
modelling suites, with ever-higher hardware 
requirements and steeper learning curves. We want to 
take a step back and focus on pure 3D modelling using 
Glise, a new free modeller with minimal hardware 
requirements and a painless interface. Built from 
scratch, it turns a Raspberry Pi into a true modelling 
tool. So let’s get started and see what your Raspberry 
Pi can do! 


We will create a coarse sketch, 


add fins, eyes, and tentacles, 
then tweak as needed 


and tentacles 
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Extrude faces and bevel 
edges to add eyes, fins, 


Set up and install 

You must first activate the experimental OpenGL 
drivers — find out how on the Raspberry Pi website 
here: magpi.cc/2knRTvS. You might also want to 
increase the GPU memory to 128MB. 

Download Glise for Raspberry Pi from 
twistednormal.com, right-click on the downloaded 
installer, and select Package Install. 

Avoid any LXDE/Glise key binding conflict (they 
both use Alt+mouse drag). You can either edit 
~/.config/openbox/lxde-pi-rc.xml and comment 
out the whole <context name="Frame"> section, or 
simply press the Function (Windows) key when using 
the Alt key to move the camera in Glise. 


Refine your model and adjust 
the pose using soft selection 
and tweak mode 
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Fig 1 Basics of tweaking a face: 
a) selection and handle 

b) translation 

c) scale 


What we are going to do 

3D modelling is an iterative process where you push, 
pull, and tweak vertices, edges, and faces. But how do 
you turn simple, geometrical primitives into an alien 
spider, a flying mussel, or a panda playing a banjo? 

As any good artist, you will start by sketching out 
the basic proportions of the model using a very coarse 
mesh, which has only few components and allows 
you to make big changes quickly. As your modelling 
session progresses, you’1l work on increasingly 
complex details, adding new, smaller components, 
either locally or by subdividing your whole model. 

We’re going to draw a squid, since they’re relatively 
easy to model, yet complex enough to let us cover 
several fundamental concepts. 


Modelling basics 

Instead of going ahead with an endless list of actions 
to perform, like ‘click there’, ‘open that’ and the 
like, let’s go through the fundamental concepts 

and procedures needed to sketch the squid head, 
which, surprisingly enough, you’ll be able to model 
all by yourself once you’ve grasped the basics. You 
might want to check the online documentation at 
magpi.cc/2knLzo2 (and you definitely should) while 
practicing, to get more in-depth information about 
the topics discussed here. 

Glise’s main window may contain several 
independent viewports, each holding either a scene 
manager, a Python console, or a modelling canvas 
(an ambient occlusion renderer is also available on 
Linux and Windows). Since we’re not going to deal 
with scene management or Python programming, 
we will focus on the modelling canvas, which, as the 
name implies, is where all the magic happens. You 
can easily spot a modelling canvas from the little axis 
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gizmo on its lower-right corner. By default, Glise 
will use a single, full-screen modelling canvas. If you 
want to change the default layout, check the online 
documentation at ‘Layouts, Viewports and Dialogs’. 
Creating a cube is straightforward: use a right 
mouse button (RMB) click anywhere in a modelling 
canvas to open the pop-up menu, and select Create 
> Cube. Now that there is an object in the scene, 
you can move the camera by pressing the ALT key 
and dragging the left mouse button (LMB) to rotate, 
the middle mouse button (MMB) to pan, or the RMB 


STICKY 
KEYS 


Focus on the modelling 
canvas, which 1s where all 
the magic happens 


to zoom. Whenever the Alt key is pressed, drag 

the mouse to move the camera. Any time you want 

to centre the cube, just press Space and it will be 
framed in the current canvas. Practise with these 
controls: moving the camera and framing things must 
become second nature. See ‘Navigation’ in the online 
documentation for more camera controls. 

All this is fine and dandy, but you won’t get very 
far just by rotating a camera around a cube. So we’re 
going to tweak a face, which is, yes, modelling! Left- 
click on a face to select it. As the face turns yellow, a 
3-axis handle is placed right on its centre (Fig 1-a). 
You can now LMB-drag any of the arrows to translate 
the selection along a direction (Fig 1-b), or LMB- 
drag the centre of the handle to move it freely. Try 
it! Dragging an arrow with the middle mouse button 
will make you scale the selection along a direction. 


TWEAK 
MODE 


March 2017 MagPi | 49 


Tutorial WALKTHROUGH 


Coarse head MMB -drag the centre of the handle for a uniform 
sketch reference: ; ' 
ey econ (he font scale on every axis (Fig 1-c). Left-click on an empty 
b) from the back area to clear the selection. Play with the handle 
and get comfortable with translating and scaling, 
change the type of components you can select and 


tweak (press A, S, D, G to switch to points, edges, 


When you model a base mesh, 
Glise automagically takes care 
of Its subdivided surface 


faces, or mixed), and remember that a simple Ctrl+Z 
will undo any unwanted change. Check the online 
documentation at ‘Preselection, Selection & Soft 
Selection’ and ‘Handles & Tweaking’ to learn more 
about selections and tweaking. 

Now one last, quick step: select a cube face and 
press X. You’re currently using the extrude tool 
to perform a face extrusion. Move the mouse left 
and right to slide the newly created face and use a 


Fig 3 Adding fins: 

a) edge selected 

b) after edge bevel 

c) during face extrusion 
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single right mouse button click to exit tool mode. 
Again, Ctrl+Z is your friend if you mess things up. 
Congratulations - you know a lot of stuff now! 


Sketching the head 


So you know how to create a primitive, rotate the 
camera, tweak components, and extrude faces. Believe 
it or not, you can easily model our target shape in 

Fig 2 all by yourself. You can skip this if you managed 
to model something close enough. Otherwise, this 

is how to proceed in five easy steps: create a cube, 
extrude a side face slightly outward, scale it smaller, 
and extrude it inward. Scale the opposite face smaller. 
Isn’t modelling awesome? 

We know what you’ re thinking: if that’s a squid 
head, what on earth have we been eating? Don’t 
worry; let us introduce you to the wonderful world of 
subdivision. Subdivision is the process of applying a 
specific set of rules to generate a more complex mesh 
from a simpler object. Glise handles each object as 
if composed of two distinct yet entangled entities: 

a base mesh and its subdivided surface. When you 
model a base mesh, Glise automagically takes care of 
its subdivided surface in real time. You may change 
the display mode of a modelling canvas by pressing 

1 to see only base meshes, 2 to see only subdivided 
surfaces and work directly on them (the default), or 3 
to see both. 

Now press PgUp twice to increase the display 
approximation level of the surface of our sketch. 
Isn’t it starting to look like a squid? Keep in mind 
that each level will eat four times more memory (and 
video memory) than the previous, so depending on 
the complexity of your model, you might not want 
to go further than a couple of levels. Use PgDn to get 
back to the previous level. See ‘Introducing Glise’ and 
‘Display’ in the online documentation to learn more 
about what we’ve just covered. 
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Eyes, fins, and tentacles 

Well, we’re done now with our rough sketch, 

and it’s time to proceed to the next level. We want 
to add a few details. Unfortunately, our base mesh 
(the one you actually model) is basically still very 
close to a simple cube. We can’t extrude fins and 
tentacles from a cube’s face, because we need 
components to work with, and in the middle of a 
face there’s only, well, a face. So follow us, and 
everything will be clear in a minute: press F to 
switch to object selection mode, select our object, 
and press Shift+PgUp (aka ‘Refine’ ). This will replace 
our base mesh with the first approximation level 
of its subdivided surface, which will keep its shape. 
Now our model has way more components, and we 
can have our fins in the right place. But wait: squids 
have a symmetrical body. Let’s work on one side 
and have Glise take care of the other! We just have 
to properly set up Symmetry on our squid: press S 
to switch to edge selection mode, and select one 

of the edges dividing the left side from the right. 
Press Alt+C (Symmetry > Compute From > Edges) 
and that’s it. Isn’t symmetry great? If instead you 
received an error message, check that the edge 

you selected really lies on the centre of the model. 
There are also other ways to compute symmetry 

— check ‘Symmetry’ in the online documentation 
to learn more. 

Back to the fins: now that we’ve refined our 
model and enabled symmetry, select an edge like 
Fig 3-a and press B to use the edge bevel tool. 

Slide the mouse like in Fig 3-b and right-click to 
exit tool mode. Now select the newly created face 
and extrude it as in Fig 3-c. We’1]1 make something 
similar for the tentacles, but we will work with 
vertices: press A to switch to vertex selection 
mode, select the vertices as in Fig 4-a, and press 
Ctrl+B to use the bevel tool on those. Right-click to 
exit tool mode when you’ re close to Fig 4-b. Then 
all we need to do is extrude the newly created faces 
as in Fig 4-c. Create the eye by using the bevel tool 
on a Single vertex and deleting the resulting face 
with Del. 

Now it’s just a matter of tweaking a bit and 
working on a few further extrusions, and your final 
result will be very much like the squid in our picture. 
It doesn’t have to be exactly the same — it must be 
what you want it to be. 


What now? 


Well, this is quite a complex subject, and this short 
tutorial wasn’t meant to cover everything. There 

are tons of books, online tutorials, and videos on 
each single topic related to 3D modelling. Still, the 
tools you used in these pages can be found in any 3D 
software package, and the fact that you’re doing this 
on your Raspberry Pi is awesome! Now draw and be 
creative, but above all, have fun! 
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Adding tentacles: 
a) vertices selected 
b) after vertex bevel 
c) during face extrusion 
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))) Sonic Pi 


SUBTRACTIVE 
SYNTHESIS 


Learn more ways to design sounds in Sonic Pi thanks to Sam Aaron 
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Raspberry Pi 
running Raspbian 


Sonic Pi v2.9+ 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 


his is the second in a series of articles on how 
to use Sonic Pi for sound design. Last month 
we looked at additive synthesis, which we 
discovered was the simple act of playing multiple 
sounds at the same time to make a new combined 
sound. This month we’ look at a new technique 
commonly called subtractive synthesis, which is 
simply the act of taking an existing complex sound 
and removing parts of it to create something new. 
This is a technique which is commonly associated 
with the sound of analogue synthesizers of the Sixties 
and Seventies, but also with the recent renaissance of 
modular analogue synths through popular standards 
such as Eurorack. 

Despite this sounding like a particularly 
complicated and advanced technique, Sonic Pi makes 
it surprisingly simple and easy — so let’s dive right in. 


Complex source signal 
For a sound to work well with subtractive synthesis, it 
typically needs to be fairly rich and interesting. This 
doesn’t mean we need something hugely complex — in 
fact, just a standard : square or : saw wave will do: 

synth :saw, note: :e2, release: 4 

Notice that this sound is already pretty interesting 
and contains many different frequencies above :e2 
(the second E ona piano), which add to create the 
timbre. If that didn’t make much sense to you, try 
comparing it with the : beep: 

synth :beep, note: :e2, release: 4 
As the : beep synth is just a sine wave, you’ 1] 


hear a much purer tone and only at :e2 and none 
of the high crispy/buzzy sounds which you heard in 
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the : saw. It’s this buzziness and variation from a 
pure sine wave that we can play with when we use 
subtractive synthesis. 


Filters 

Once we have our raw source signal, the next step is 
to pass it through a filter of some kind, which will 
modify the sound by removing or reducing parts of it. 
One of the most common filters used for subtractive 
synthesis is something called a low-pass filter. This 
will allow all the low parts of the sound through, but 
will reduce or remove the higher parts. Sonic Pi has a 
powerful yet simple-to-use FX system that includes a 
low-pass filter, called :1lpf. Let’s play with it: 


with_fx :lpf, cutoff: 100 do 
synth :saw, note: :e2, release: 4 
end 


If you listen carefully, you’ ll hear how some of that 
buzziness and crispiness has been removed. In fact, 
all the frequencies in the sound above note 10@ have 
been reduced or removed, and only the ones below are 
still present in the sound. Try changing that cutoff: 
point to lower notes, say 70 and then 5@, and compare 
the sounds. 

Of course, the :lpf isn’t the only filter you can use 
to manipulate the source signal. Another important 
FX is the high-pass filter, referred to as :hpf in 
Sonic Pi. This does the opposite to :1lpf in that it lets 
the high parts of the sound through and cuts off the 
low parts. 


with_fx :hpf, cutoff: 90 do 


synth :saw, note: :e2, release: 4 
end 
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Notice how this sounds much more buzzy and raspy 
now that all the low-frequency sounds have been 
removed. Play around with the cutoff value —- note 
how lower values let more of the original bass parts 
of the source signal through and higher values sound 
increasingly tinny and quiet. 


Low-pass filter 


The low-pass filter is such an important part 

of every subtractive synthesis toolkit that it’s 
worth taking a deeper look at how it works. This 
diagram (top right) shows the same sound wave 
(the :prophet synth) with varying amounts of 
filtering. At the top, section A shows the audio 
wave with no filtering. Notice how the wave form 
is very pointy and contains lots of sharp edges. It 
is these hard, sharp angles that produce the high 
crispy/buzzy parts of the sound. Section B shows 
the low-pass filter in action - notice how it is less 
pointy and more rounded than the wave form 
above. This means that the sound will have fewer 
high frequencies, giving it a more mellow, rounded 
feel. Section C shows the low-pass filter with a 
fairly low cutoff value - this means that even more 
of the high frequencies have been removed from 
the signal, resulting in an even softer, rounder 
wave form. Finally, notice how the size of the wave 
form, which represents the amplitude, decreases as 
we move from A to C. Subtractive synthesis works 
by removing parts of the signal, which means that 
the overall amplitude is reduced as the amount 

of filtering that is taking place increases. 


Filter modulation 

So far we’ve just produced fairly static sounds. In 
other words, the sound doesn’t change in any way for 
the entirety of its duration. Often, you might want 
some movement in the sound to give the timbre some 
life. One way to achieve this is via filter modulation — 
changing the filter’s options through time. Luckily, 
Sonic Pi gives you powerful tools to manipulate an 
FX’s opts through time. For example, you can set a 
Slide time to each modulatable opt to specify how long 
it should take for the current value to linearly slide to 
the target value: 


with fx :lpf, cutoff: 50 do |fx| 
control fx, cutoff_slide: 3, cutoff: 130 
synth :prophet, note: :e2, sustain: 3.5 
end 


Let’s take a quick look at what’s going on here. 
Firstly, we start a : lpf FX block as normal with an 
initial cutoff: of a low 50. However, the first line 
also finishes with the strange |x| at the end. This is 
an optional part of the with_fx syntax which allows 
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Synth :prophet, note: :el ~~ —— 
| | 

with_fx :lpf, cutoff: 70 do 

synth :prophet, note: :el —/ —— —S 
end 
with_fx :lpf, cutoff: 50 do 

synth :prophet, note: :el 
end 


you to directly name and control the running FX 
synth. Line 2 does exactly this and controls the FX to 
set the cutoff_slide: opt to 3 and the new target 
cutoff: to be 130. The FX will now start sliding the 
cutoff: opt’s value from 5@ to 130 over a period of 
three beats. Finally, we also trigger a source signal 
synth so we can hear the effect of the modulated 
low-pass filter. 


Bringing it all together 
This is just a very basic taster of what’s possible when 
you use filters to modify and change a source sound. 
Try playing with Sonic Pi’s many built-in FX to see 
what crazy sounds you can design. If your sound feels 
too static, remember you can start modulating the 
options to create some movement. 

Let’s finish by designing a function which will play 
a new sound created with subtractive synthesis. See 
if you can figure out what’s going on here — and, for 
the advanced Sonic Pi readers out there, see if you can 
work out why we wrapped everything inside a call to 
at (please send answers to @samaaron on Twitter). 


define :subt_synth do |note, sus| 
at do 
with fx :lpf, cutoff: 40, amp: 2 do |fx| 
control fx, cutoff_slide: 6, cutoff: 100 
synth :prophet, note: note, sustain: sus 
end 
with fx :hpf, cutoff_slide: @.@1 do |fx| 
synth :dsaw, note: note + 12, sustain: sus 
(sus * 8).times do 
control fx, cutoff: rrand(70, 110) 
Sleep 0.125 
end 
end 
end 
end 


subt_synth 
Sleep 8 
subt_synth 


:e1, 8 


:e1l - 4, 8 
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BUILD LOGIC GATES WITH 


GPIO ZERO 


SOQURCE/VALUES 


Learn how you can use source/values in GPIO Zero to easily connect 
devices together using a declarative style of programming 


The latest version 
of GPIO Zero 
magpl.cc/ 
2kmDusl 


Full-size 
breadboard 


3x LEDs 


3 x 330Q resistors 


2 x push buttons 


7 x male- 
to-female 
jumper wires 


What is source/values? 
GPIO Zero is more than just a friendly API: it 
comes with some powerful tools for helping you 


ource/values is a more advanced feature 
of GPIO Zero, but it’s incredibly powerful 
and much simpler than you’d think! You 


2 x male-to-male 
jumper wires 


can do more with less code, and it saves you from 
using while loops to keep updating the state of your 
devices. This clever concept allows you to describe 


program your next project. While you can start 
with simple procedural code, where each line is 
followed in sequence, you can progress to event- 


how devices should behave, making your code 
more concise. 

Source/values is easy to get started with, and takes 
a keen mind to master. There’s some magic going on 
beneath the hood! You will learn how it all works, and 
put it into action by creating logic gates (AND, OR, 
and NAND), using LEDs and buttons. 


driven programming, meaning various events can 
be triggered in any order, or at the same time. And 
finally, the darkest of dark arts, source/values brings 
forth a third programming paradigm: declarative. 
This means you describe an object’s behaviour in 
one line, and it will follow that instruction in the 
background. This is really handy if you have lots 

of things going on at once! 

Source/values is the name for the concept 
in GPIO Zero for telling a device how it should 
behave, or for connecting up multiple devices 
together so they act in a particular way. Every 
GPIO Zero device has a .value property which 
you can read at any time: a button will tell 
you if it’s pressed (True) or released (False), 
and an LED will tell you if it’s lit (True) or not 
(False). Output devices (like LEDs) can have their 
value set; led.value = True will light the LED, 
just like using led.on(). 

Every device also has a .values property, which 
..  iSaniterator constantly yielding the current value. 
+» Output devices have a .source property which 
is where you tell the device where it should get 
its values from. Commonly, this will be another 
device’s .values property, which is an easy way of 
connecting two devices together. For example, 
led.source = button.values means the LED will 
be on when the button is pressed. 


LEDs represent OUT1, 
OUT2, and OUT3 


Buttons represent 
IN1 and IN2 


PGRSEESSeeeeaes 


Each button and LED is connected 
to ground (GND) and a GPIO pin 


raspberrypi.org/magpi 


54 | MagPi March 2017 


source_values.py 


from gpiozero import LED, Button 

from gpiozero.tools import all _ values, any_values, negated 
from signal import pause 

in 1 = Button(@) 

in 2 = Button(1) 

out_1 = LED(2) 

out 2 = LEDC3) 

out_3 = LED(4) 


out_1.source 
out_2.source = 
out_3.source 


all values(in 1.values, in 2. 


negated(out_1.values) 


pause() 


The magic under the hood 

This concept was developed by Dave Jones (author 
of the picamera library and co-developer of GPIO 
Zero) based on an idea formed in a GitHub issue 
(rpf.io/gpz76). The way it works is that when a 
device’s source is set, a background thread is created 
to constantly set the device’s value to the next item 
in the iterator. If source is set to another device's 

. values, this is effectively always reading the other 
device’s current value. It doesn’t have to be, though: 
it can be any iterator, or you can write your own 
function to send values to the device. 

A handy thing about GPIO Zero is the fact that 
devices tend to have a standard value range — usually 
a Sliding scale from 0 to 1 (or True and False, which 
are effectively just 0 and 1). This means that you can 
pass the values from one device into another: like a 
potentiometer (0-1) into a PWM LED (0-1) to dial up 
the brightness. Exceptions include Motor, which goes 
from -1 to 1 (-1 being full speed backwards, 1 full speed 
forwards), and composite devices like Robot, which is 
a tuple (-1, -1) to (1, 1) for left and right motor speeds. 


Why is it useful? 

Using this method of connecting devices is much more 
concise. Rather than using awhile loop (five lines) to 
constantly check if a button is pressed to turn an LED 

on or off, or using an event-driven approach (two lines: 
when_pressed and when_released), one line tells it to 
match the button: led.source = button.values. 

As well as connecting two devices directly together, 
you can process the value in between, using a custom 
function. GPIO Zero provides a set of commonly 
used tools for this kind of processing. Importing the 
negated function from gpiozero.tools allows you to 
specify that an LED should be lit when the button isn’t 
pressed: led.source = negated(button.values). 
See more source tools in the docs at rpf.io/st. 
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BUILD LOGIC GATES 


# Golozero 


qanguage 


>PYTHON 


Programming logic gates 
Let’s begin. First, wire up two buttons and three 
LEDs on a breadboard. You’1] need to import the 
epiozero LED and Button classes, and the all_ 
values, any_values, and negated source tools. 
Create objects representing each of the LEDs and 
buttons, providing the pin numbers they’re wired 
to. The buttons represent two inputs; the LEDs three 
outputs. You’re going to program the first LED to 
represent the binary AND of the two inputs, the 
second to represent the OR, and the third the NAND. 
To define the AND of the two buttons, you’ll need to 
use the all_values function from gpiozero.tools; 
all_values yields True if all of the inputs are True, 
which is an AND gate: 


DOWNLOAD: 
magpli.cc/ 
ZeroSourceValues 


Above Read up 
in the gpiozero 


at rpf.io/sv 


out_1.source = all _values(in_1.values, in_2.values) 
To define the OR of the two buttons, you can use the 
any_values source tool; any_values yields True if 
any of the inputs are True, like an OR gate: 
out_2.source = any_values(in_1.values, in_2.values) 
You could define the NAND button using a 
combination of negated and all_values, but since you 
have already calculated the AND, you can simply read the 
state of the AND LED and negate that: 
out_3.source = negated(out_1.values) 
Finally, if you’re running this code from a file rather than 
a Python shell, the last line, pause(), will keep your script 
running. Run your code and you’ll see the NAND LED lit up. 
That’s because (with no buttons pressed), it’s the only gate 
that’s active according to the rules. Try pressing the buttons 
in different combinations to check your logic! Now try 
programming some more logic gates: XOR, NOR, and XNOR. 
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> 2x crocodile clips 


> 2x male-to- 
female jumper 
leads 


> A speaker 


> Craft stuff: 
paper plates, 
cardboard, 
aluminium foil, 
glue, scissors, 
sponge, bulldog 
or paper clips, 
sticky tape 


WALKTHROUGH 
CARRIE ANNE PHILBIN 


Carrie Anne is the director of education 
at the Raspberry Pi Foundation 

and also the author of Adventures 

in Raspberry Pi. 
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PROJECT 


Enter the Pioneers 
challenge here: 


A Pi-powered retro prank, perfect to get your mind thinking 
about a Pioneers project! 


n the bad old days before TV and computers, ‘PARP!’ noise, causing him to jump into the air and 

the most popular form of family entertainment making his false teeth fly out. It was the best thing 

was the whoopee cushion, a tooty balloon ever. This project brings the whoopee cushion up to 
originally made from a pig’s bladder. The whoopee date: there’s no bladder and no need to blow it up. 


cushion would be inflated and hidden under Grandad’s_ —_ Thanks to the Raspberry Pi, you can also add whatever 
chair cushion. When he sat down, it would make aloud __ noises you want! 


Behind the sofa may not 
be the best place to hide, 


but you'll need to see your 


prank in action 


This look of discontent 
is what every prank 
should strive for 


An electrically 
powered trump 
machine, ready 
to prank 
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MAKE AWHOOPICUSHION ‘Tutorial 


Making the Whoopi cushion 

Cut a circle from the cardboard to fit the centre of the 
‘eating’ side of each paper plate. Tape or stick squares 
of foil onto the cardboard. These are your contacts: 
when they touch, they will complete a circuit. Using 
some copper tape, connect the foil to the edge of the 
plate. Chop the sponge up into cuboid chunks and 
glue them around the foil on one of the plates: this 
will stop the foil squares touching each other until 
someone sits on the plate. It should look something 
like Fig 1. 

Put the two plates together so that the foil pieces 
are on the inside and facing each other. Offset the 
paper plates so that the copper tape sections are 
not touching. 

You now have a ‘cushion’ made of two plates. You 
can tape the plates together, or you might choose to 
use bulldog or paper clips so that you can test that 


your cushion works correctly, and easily debug any Test the sound fie eee 
hardware problems. That’s the hardware complete. Now for the software! tech. We'll use it to 


We’re going to use Python. Don’t worry if you haven’t —'"@K¢ farting souncis 


Connect the Whoopi cushion to the Pi used it before: just follow the instructions and you’ ll 


Plug one header lead (it doesn’t matter which) onto pick it up. You’1] be using the command line to enter 

a ground (GND) pin on the Pi (refer to Fig 2). Plug commands. To do this you’1l need to open a terminal 
the other wire onto GPIO pin 2 (Fig 3, overleaf) and window by clicking on the terminal icon: it looks like a 
then clip a crocodile clip cable to one of the paper computer screen, and is found three icons along from 
plates’ copper tape sections. Connect the otherendof the Menu button on your desktop. 

the crocodile clip cable to the male pin of one of the Connect the speaker to the Raspberry Pi using the 
connected jumper wires (Fig 4). Repeat these last two sound jack. Create a new folder called whoopee by 
steps to connect the other plate to your Raspberry Pi. typing the following command in the terminal and 
Your setup should look similar to Fig 5. pressing Enter on the keyboard: 


Fig 2 If you have 
an older Raspberry 
Pi model you'll 
only have 26 pins, 
but they have the 
same layout 


| 
e 
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Fig 3 Again, 
this will be the Fig 4 It's avery 
same pin on any simple step but 
Raspberry Pi best to get it right 


mkdir whoopee To switch audio to the headphone jack, return to the 
terminal window and type the following command: 
Next, use cd whoopee to enter the folder you 


have just created. We’re going to need a sample amixer cset numid=3 1 
sound file for this project, so we’ll use one from 
Sonic Pi. Download this burp sample using the If your Raspberry Pi is connected to the internet, 
following command: you could search for some suitable trumping sounds. 
They need to be in WAV format to work. Alternatively, 
wget http://rpf.io/burp -O burp.wav download our example sounds here: rpf.io/farts. 
Now, test that you can play the sound file using Write a program In Python 
aplay by typing: Open Python 3 (IDLE) from the Programming menu 
and click on File > New Window. This will open a blank 
aplay burp.wav file. Click on File > Save As, name the file whoopee.py 


and then type the following code into your file: 
You should hear it from the speakers or headphones 
connected to your Pi. If you can’t hear anything, make 


sure that your speakers are connected correctly. If import os 
this still doesn’t work, you’ll need to change your import random 
audio configuration. from time import sleep 


from gpiozero import Button 


This part of the code pulls in all the libraries that 
you're going to use to write your program. You’ll then 
need to use the Button class in your code. You’|l have 
to tell it that the button is on pin 2. To do this, write 


es Nis R | om 
Pp | ON [Ee = RS the following code in your new file: 
Ss . Ps ve 


button = Button(2) 


Now create a list of all your sound effects and store 
them inside a variable that you can call later on in 


MAKE YOUR OWN PRANKS your code: 


trumps = ['ben-fart.wav', 'ca-fart.wav', 
Think you can do better than this? The Raspberry ‘marc-fart.wav' | 


Pi Foundation is running a competition for folks 

between 12 and 15, and all you need to do is make In Python, square brackets are used to create a list. 
them laugh using digital technology. Sound easy? Each item in the list is separated by a comma. 

Sound fun? Then check out the website for more Once all the setup needed in the code is complete, 
details: magpi.cc/2iHKIP5 you can move on to writing the part of the program 
that will make something happen when the button is 
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pressed. Begin by creating a loop using while True:. 
Then, add button.wait_for_press() inside the loop 
by indenting by four spaces. Each time around the 

loop, the computer waits for the button to be pressed. 

On the next line, use the random. choice function 
to select a sound at random from the list you created 
earlier. That selected sound needs to be stored inside 
another variable which you can call parp! Type parp = 
random. choice(trumps ). 

The next line will play the sound selected at random 
using aplay, as used earlier when testing sounds. 
Type os.system("aplay {0}".format(parp) ). 
Finally, add sleep(2) to pause the program before it 
Starts the loop again. Your code should look like this: 


while True: 
button.wait_for_press() 
parp = random.choice(trumps) 
os.system("aplay {0}".format(parp) ) 
sleep(2) 


Save the file by clicking on File > Save. Test that your 
code works by clicking on Run > Run Module. Use your 
hand to push the top plate of your Whoopi cushion 
down to make a connection between the foil sheets, 
and you should hear a fun sound. If it doesn’t work first 
time, don’t worry. Check your code through. Have you 
typed your code out exactly as you see it here? 
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MAKE A WHOOPI CUSHION 


Tutorial 


Fig 5 Yours may be 
considerably tidier 
than this. Or messier. 
It's all good 


qanguage 


>PYTHON 3 


whoopee.py 


import os 

import random 

from time import sleep 

from gpiozero import Button 


DOWNLOAD: 
magpi.cc/ 
WhoopiCushion 


button = Button(2) 
trumps = ['ben-fart.wav', ‘ca-fart.wav', ‘marc-fart.wav' | 


while True: 
button.wait_for_press() 
parp = random.choice(trumps ) 
os.system("aplay {0}".format(parp) ) 
sleep(2) 


Setting it up 

Carefully place your cushion in a spot where your 
victim will sit on it (obviously!), but not under a really 
heavy cushion where it will be squashed straight 
away. The tricky bit is setting up the Pi so that it 

can’t be seen: remember, you’1l need a plug socket to 
connect it to the power, unless you’re using a battery 
pack. Run the program, and wait. Here’s a hint: 
whistle tunelessly and look around at the ceiling. This 
will make you seem innocent, and will help to attract 
potential victims. 


March 2017 MdgPi | 59 


Running Exited 


70 Events 


See the current status of 
each process at a glance 


See a history of when processes 
exit to spot if there's any patterns 


Receive a text message or email 
whenever a process exits 


REMOTELY MONITOR 
YOUR PI PROCESSES 


Create a web-based dashboard of all your important processes and get 


60 


Initial State 
account 
magpi.cc/ 
2kiYp77 


a notification when one exits 


f you’re using one or more Raspberry Pis to 
run a dedicated task (e.g. weather station or 
monitoring your beer fridge), you need those 
processes to run uninterrupted. A task that exits 
unexpectedly may need your immediate attention 

to avoid lost data, project delays, or a system failure. 
It’s impractical, though, to manually babysit a bunch 
of Raspberry Pis. A better way to ensure continuous 
operation is to be alerted when a process exits, and be 
able to pull up a single dashboard to see the status of 
every important process running on every one of your 
deployed Raspberry Pis. 


Initial State 


We want to stream the status of each of our processes 
to a web service and have that service turn our data 
into a nice dashboard that we can access from our 
laptop or mobile device. Our data needs a destination, 
and we’ |! use Initial State as that destination. First, go 
to magpi.cc/2k1Yp77 and create a new account. Next, 
install the Initial State Python module onto your Pi: 


cd ~ 
\curl -sSL https://get.initialstate.com/ 
python -o - | sudo bash 


Follow the prompts, including the step of creating a 
test script to ensure you can successfully stream data 
from your Pi. 
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Monitor a process 

Whenever you run a program or Script on your Pi, 
you initiate a process. Each running process will 
have a unique process ID number (PID). You can see 
every process owned by you by typing ps at your Pi’s 
command prompt. You will see a response that looks 
something like this: 


PID TTY: 
TIME CMD: 


3373 pts/O 
00:00:00 ps 


3359 pts/O 
00:00:01 bash 


If you want to find every running Python process, 
you can use the following command: 


$ ps -ef | grep py 


root 2287 1 © Dec@9 ? 
00:00:08 sudo python /home/pi/weather/ 
weather. py 


In the example above, the PID of the weather 
Python script is 2287. Once we know the PID of the 
process we want to monitor, we can pass this number 
aS a parameter into a simple Python script that 
will monitor the existence of this defined process 
and send either a ‘Running’ or ‘Exited’ response to 
our dashboard. 

We will use the Python script located at 
magpi.cc/2kj3BYs. Before we can use this script, 
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REMOTELY MONITOR YOUR PI PROCESSES 


we need to set each of our user settings at the top 
of the file. 


BUCKET_KEY specifies the data bucket our script 
will stream into. Make sure you use the same 
BUCKET_KEY for each script that should send data 
into the same dashboard. 


ACCESS_KEY is your unique Initial State account Key. 
This key is used to send data into your account from 
the scripts. You can find your ACCESS_KEY in the 
Streaming Access Keys section of your Initial State 
account settings. 


PROCESS NAME is the name of the specific process 
you’re monitoring that you want to display on 
your dashboard. For example, PROCESS NAME = 
"Franklin Weather Station". 


You can run this script as follows: 
python monitor_process.py <pid> 

To run this in the background without interruption: 
nohup python monitor_process.py <pid> & 


Manually finding the PID is cumbersome. Let’s 
make it a bit easier by creating another simple script 
that will find the PID automatically and launch our 
monitor_process script. 


Launch a monitored process 
We can use a simple Bash script to do three things: 
launch our important task/program/process, find the 
PID of the task/program/process we just launched, 
and pass the PID into our monitor_process script. 
The Bash script that we’ll modify and use is located 
at magpti.cc/2kiS23q. 
To use this script, simply modify the two user 
settings at the top of the file: 


PROCESS2RUN is the process you want to run and 
monitor. Specify the full path. 


MONITOR_SCRIPT is the monitor_process.py script we 
just created. Again, specify the full path. 


Before you run this script, you’1l need to make it an 
executable file. Run the following: 


chmod u+x launch_process.sh 
To run the script: 
./launch_process.sh 


We could stop here and have a pretty good solution 
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for monitoring our processes. However, we need to 
consider what happens when we have a power outage. 


Monitor a reboot 

If power drops, our process will instantly die, as will 
our monitoring script and network connection. On 
reboot, we need to do two things: send an update to 
our process dashboard that our process exited, and 
automatically start our process and process monitor 
after the reboot completes. 

First, let’s create a script that will run on reboot to 
send a ‘process exited’ status to our dashboard. We’11 
use the script at magpi.cc/2kiTfla. The user settings 
at the top of this script need to be set just like the 
other scripts. Make sure you use the same BUCKET_ 
KEY, ACCESS_KEY, and PROCESS_NAME as in the 
‘Monitor a process’ step. Once this script is set up, 
we need to call it automatically on reboot. 


Automatically launch on boot 
To automatically launch our scripts on boot, we will 
use crontab: 


crontab -e 


At the end of the file that opens, add the 
monitor_reboot script and the launch_process 
script. Specify the full path. For example, you’ll add 
a Single line that looks something like the following 
(with your specific paths): 


@reboot python /home/pi/weather/monitor _ 
reboot.py && /home/pi/weather/launch_ 
process.sh 


Notice the monitor_reboot script is followed by 
&&. This specifies that the monitor_reboot script 
should complete before the next command runs. If 
there’s a power outage, it may take a few minutes 
for your network connection to be restored. After the 
delays specified in the monitor_reboot script expire, 
Status updates will be sent to your dashboard and 
your process will be launched. 

Once this is in place, everything will be automated. 
Every time your Pi boots, your process dashboard 
will update, and your process will launch and 
be monitored. 


Dashboard and notifications 

Each process that you monitor will add a data tile to 
your dashboard. This can be extremely useful if you 
have an application where multiple Pis are deployed 
across multiple locations. For example, if a Pi is used 
to monitor temperature in every room in your office 
building, you can quickly see the status of every Pi ata 
elance. You can enable SMS and/or email notifications 
for each process status by going to the Triggers section 
of your data bucket settings. 


Tutorial 


qanquage 


>PYTHON 


DOWNLOAD: 
magpi.cc/2iUSsAY 


INITIAL STATE 


Initial State is 
an easy-to- 
use platform 
for collecting 
data from 
connected 
devices and 
turning that 
data into 
dashboards, 
waveforms, 
notifications, 
and more. 
initialstate.com 
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FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


RASPBIAN 
INTERFACES 


Right Raspberry Pi 
Configuration holds 
all the important 
Raspbian settings 


PIXEL 

The graphical user interface (GUI) for Raspbian is the 
main way to use the Raspberry Pi. From here you can 
access traditional browsers, office suite apps, and the 
programming IDEs. This is the interface most people 
will use and the one which is recommended. 


Command line 

The classic command-line interface (CLI) requires you 
to input text commands and there’s very little in the 
way of graphics outside of ASCII art. You can control the 
Raspberry Pia bit more directly from here, while still 
being able to code. 


Custom interface 

You can also create custom interfaces for your Raspberry 
Pi: we’ve seen Python-powered phone-style interfaces 
you can use, and there are a few web-based interfaces 
around as well. The latter are very popular in CCTV or 
robotics applications. 


Expand Filesystem 


‘Change Password... | 


raspberrypi 


® To Desktop © ToCLI 


Login as user ‘pi’ 


© Enabled © Disabled 


| Add to Rastrack... 
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Default interface 

You can select which interface to use by default from the 
Raspberry Pi Configuration tool under Preferences in the 
program menu. It is set to boot to the desktop by default, 
but you can also set it to boot straight into the command 
line if it suits your usage. 


Switch while running 

You can switch between the desktop and CLI while the Pi 
running. From the command line, using the command 
startx will boot up the desktop. From the desktop, you 
can quickly switch to a command-line interface using 
CTRL+ALT+F2. You can then switch back to the desktop 
interface with CTRL+ALT+F1. 


Custom interfaces 

Most custom interfaces, at least ones running directly 
from the Pi, require the desktop be running so it can use 
the graphical tools to display them. Keep that in mind 
while making something that turns on automatically at 
boot. Check what is required for web interfaces. 


Defaults 

By default, the Raspberry Pi will log you in whichever 
way you boot up. For most uses this is fine; however 
there will always be cases where this is quite insecure. 
As education is the main focus of the Raspberry Pi 
Foundation, though, this is why it’s turned on. 


Change it 

You can change whether or not the Pi automatically 

logs in. Go to the Raspberry Pi Configuration menu. 
Underneath the option to change which desktop it boots 
into, you’ ll find the option to turn auto login on and off. 


Password 

For Raspbian, the default user name is pi and the 
password is raspberry, so you’ll need to remember that 
if you turn off auto login. If you’re turning it off for 
security reasons, it’s a good idea to change the password 
as well. Find out how to do so here: magpi.cc/2iqm9pO. 
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What size SD card do! need for the Raspberry Pi? 
Whether you want to use the NOOBS installer ora 
standalone distro image, the minimum size SD card we 
recommend is 8GB. This will give you the free space you 
need to install extra packages or make programs of your 
own. The original Raspberry Pi Model A and Model B require 
full-size SD cards. The newer Raspberry Pi Model A+, Pi 
Model B+, Pi 2 Model B, Pi Zero, and Pi 3 Model B require 
microSD cards. 


What size SD cards can it support? 

We have tried cards up to 32GB, and most cards seem 
to work fine. You can also attach a USB stick or USB hard 
drive to provide extra storage. 


What happens if I brick the device? 
You can restore the device by reflashing the SD card. 
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WiLL it run Android? 

No. While a version of Android can be found in the 
forum, it is not stable enough for everyday use. There 
are no plans to continue working on it, since Android 
does not provide any enhancement to educational 
purposes that are not already fulfilled more readily 
with existing software: we see it as a platform for 
consumption, not for creation. 


WiLL it run [insert name of program here]? 

In general, you need to look to see whether the program 
you want can be compiled for the ARMv6 (Pi 1) or ARMv7 
(Pi 273) architecture. In most cases, the answer will be 
yes. Specific programs are discussed on our forum, so 
you might want to look there for an answer. Ultimately, 
though, nothing beats grabbing a Raspberry Pi and 
finding out the answer through direct testing! 


wD PIDRIVE 
NOWE ZER® 


COMPACT AND PRE-ASSEMBLED 
WITH A HDD AND RASPBERRY PI ZERO. 


Build your own mini DLNA + Samba file server, wireless mobile 
storage device, or a Pi MusicBox with local storage, and more. 


Includes: 
¢ 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 
e SD card with starter software 

¢ Mini HDMI adapter cable 


Learn more at wdlabs.wd.com/magpi55b 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 
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Petite, efficient, and well connected. 
Meet the latest member of the Raspberry Pi family 


he big news this month is 

the introduction of a new 

computer model from the 
Raspberry Pi Foundation. 

The Pi Zero W is the same small 
revolutionary board that rocked 
the maker community, but it 
now packs built-in wireless LAN 
networking and Bluetooth. 

It also comes with an incredible 
new case. With switchable lids, 
this enables the Pi Zero W to 
function as a camera, provides 
access to its GPIO pins, or lets it act 
as a secure node. 


A third of the size of a Raspberry 
Pi 3, the Pi Zero W still has enough 
power to run a full operating 
system like Raspbian. 

This update to the Pi Zero 
has the same small form 
factor, but crams in wireless 
LAN networking too. With the Pi 
Zero W, you can connect directly 
to a local wireless network without 
having to attach a USB dongle. 

The Pi Zero W gets the 
same wireless networking 
capabilities first deployed 
on the Raspberry P13. 


Squeezing wireless networking 
onto a Pi Zero board hasn’t been 
easy, and the way Raspberry 
Pi went about it has shown 
considerable ingenuity. The new Pi 
Zero case is also a thing of wonder. 

But it’s what you can now do 
with a Pi Zero W that is going to 
make a difference. 

The Pi Zero W can connect 
automatically to a local network. 
With its small size and low-energy 
footprint, it’s ideal as a node for 
projects around the home, as well 
as loT and wearable projects. 
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PI ZERO 


Technical Specifications 


Ap i 65mm x 30mm x 5mm 
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Broadcom BCM2835 
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2.4GHz 802.11n wireless LAN 
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Bluetooth 4.1 LE 
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5V, supplied via micro USB connector 
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1080P HD video & stereo audio 
vid mini-HDMI connector 
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MicroSD card 


Micro USB 
40-pin GPIO, unpopulated 
Run mode, unpopulated; RCA composite, 


unpopulated 


Camera Serial Interface (CSI) 
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feature 


he technology found in 
T the Pi Zero W is similar to 
that of the original Pi Zero, 
only now everything has had 
to make space for an incredibly 
smart radio antenna. This 
design enables the minute 
Pi Zero board to pack a complete 
wireless LAN and Bluetooth 
connection module. 
The Pi Zero W contains all of 
the technology from the original 
Pi Zero, but with a slightly 
redesigned board. 
The technical surge forward is 
thanks to the presence of 2.4GHz 
802.11n wireless LAN and Bluetooth 


eo @ @ ° oO oe @@2068060600 
nee @'@ @ @ee@e@@e@0@00 0: 
fe a] tom | row ) Bh 


| exc a 4 pone); =| my 
AM oes A inti ws 
ré = ' : 
wey aT | e ell 
er — ‘ol oy ee 55 
ony |! || Game vOnay 2 
one! ‘ae hi) | 
ee | ee 
onsy X,, ||) 0 
ones. %, ~~ 
2. | aan i 
Baas . FOOT, om, ¢ ted De 8: 
a ae fe 8) ay | ‘| 
yee ee a ay yes , 8) el 
‘ae; 


: 7 ; ’ : 7 
98 e* ,« + woe @ ra rNe“e 
: ia ew = = os ae Oe oe 


~ . ™ 
Nene ey nt niiag tee ees Oe OER f 


P| ZEROW [require 


4.1 LE. These make the Pi Zero W To hook up stock cables, you’ll to the Pi Zero W. It’s especially 

much more accessible to makers. want a Raspberry Pi Zero Adapter pertinent thanks to the new case. 
It reminded us how packed Kit (£4, magpi.cc/2kPZNzn) to get The processor remains a 

with technology the Pi Zero is. the most from your Pi Zero W. Broadcom BCM2835 containing 


It features a full 40-pin GPIO 
header (unpopulated, so you will 


need to solder the pins on yourself). The Pj ZETO W is a full CcomputeY, 


Two extra TV pins are used 


to connect the Pi Zero W to an capable of running Raspbian and 


RCA television, while two pins ; 
ite SUNOS ers other Linux operating systems 
in a reset button. 

A single USB On-The-Go 


connection allows you to hook up A CSI connection supports an ARM11 running up to 1GHz. The 
devices to the Pi Zero W, and the the Camera Module v2 Pi Zero W is a full computer, capable 
mini HDMI socket connects the (magpi.cc/28IjIsz). This adds a of running Raspbian and other 
board to monitors and TVs. Sony IMX219 8-megapixel camera Linux operating systems. 


01. GPIO header O06. MicroSD card 


Pi Zero W has the same AmicroSD card is used to 
C) / Ge) / () / (Cy / () } 40-pin GPIO header as the provide the storage for the 
ZF ‘ng “= “ , larger Raspberry Pi models, Pi Zero W. 
but it's unpopulated. Adding 
pins to the PiZeroWboardis 07. Mini HOM! 
a great first soldering project. Amini HDMI connection 
is used to connect the 
02. Micro USB Pi Zero W to a TV or monitor. 
A single micro USB port is 
used to provide connectivity. O98. RUN pins 
Only now you don't need to The two RUN pins can 
add a USB WiFi dongle, so be used to wire up a 
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it'll be easier to connect justa reset button. 
keyboard and mouse. 


" "7 e | J | . 09. TV pins 
: 03. Micro USB power The TV pins can be used 
| ; i sates t © 9) pom The second micro USB port to add an RCA video 
~~ s} - is used to provide power connection. Perfect for 
oan ~ fia | Cc ) , to the board. hooking up a Pi Zero W to 
an ae : a 4 older television sets (for retro 
aS oie Se eb amaaan 04. Wireless LAN gaming perfection). 
at Voser i This triangular shape is 
, / used to boost the wireless 10. Camera Module 
if. connection. The signal A camera port was added to 


bounces around the triangle the Pi Zero 1.3 and remains 
| and connects to the points at on the Pi Zero W. The Camera 
: the bottom (before being fed Module is tightly integrated 
/ up the pipes to the side). with the Pi Zero thanks to the 
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new case. 
05. Bluetooth 4.1 

The Pi Zero also connects 11. Broadcom BCM2835 
to Bluetooth 4.1. This This Broadcom BCM2835 


connectivity makes it easy to SoC is the heart of the Pi 
hook up wireless devices and Zero W. It contains An ARM 11 
share files with the board. CPU running at up to 1GHz. 


feature 


oger Thornton is.the 

person in charge of the 

Raspberry Pi Zero W 
project: developing the new board 
has been a labour of love for him. 

The first Raspberry Pi product 

to gain wireless networking 
was the Raspberry Pi 3 (released 
shortly after the original Zero). 
Developing this product gave 
Raspberry Pi the experience 


THE 


PI ZERO 


“but we were getting better at 
squeezing features onto products, 
so we did a little playing around 
with the design.” According to 
Roger, there was a lot of “pushing 
and shoving” to fit all the 
components into a restricted area, 
and onto one side of the board. 
The Raspberry Pi 3 layout was 
based on a two-sided Broadcom 
reference design, with a ‘chip’ 


Theyre very clever boffins. 
Its areally neat design 


they needed to bring wireless 
networking to the Zero. 

There was no easy way the 
wireless layout from the larger 
Raspberry Pi 3 board would fit on 
the diminutive Zero. “We thought 
it was impossible,” muses Roger, 


antenna. In contrast, the Zero W 
uses a Single-sided layout 
with a PCB antenna; this is the 
trapezoidal shape between the 
mini HDMI and micro USB sockets 
on the bottom edge of the board. 

“The Raspberry Pi 3 antenna is 
a surface-mount component,” 
explains Roger, “whereas the 
Zero W antenna is a resonant 
cavity which is formed by etching 
away copper on each layer of the 
PCB structure.” 

The technology is licensed from 
a Swedish company called Proant 
(you can see the credit on the 
reverse of the Zero W board). 

“They re very clever boffins,” 
says Roger. “It’s a really 
neat design.” 


This free space is used to . 
interact with the radio waves. 

They resonate in this cavity at 7 
just the right frequency. 


At the lower part of the 
ground plane sit two me 
capacitors. These capture 

the radio signal. 
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The white text is added to the PCB using a silk-screen technique. 
These markings are used to provide information and branding for the board 
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PI ZERO W 
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You'll need the latest version of Raspbian with PIXEL 
from raspberrypi.org/downloads. Make sure you get 
the most recent update, as the latest version adds Pi 
Zero W support. Put your Pi Zero W inside its case. 


‘eeeeeeee eee e ee ee eee @ 
€ weee#e#ee4e«eee7ae4e4aeue54u4agGeeeeee2 @ & 
) - ee — y - ss 


oy 


Flash the microSD card and insert it into your Pi 

Zero W. Use a USB On-The-Go adaptor to connect 
your keyboard and mouse to the micro USB port 
marked ‘USB’ (chain the mouse via a keyboard USB if 
possible). Use a mini HDMI to HDMI cable (or adapter) 
to connect the Pi Zero W to a monitor. 


Connect a power supply to the micro USB port 
marked ‘PWR’. The Pi Zero W will power up into 
Raspbian with PIXEL. Click on the wireless icon in the 
top-right of the screen to locate your local wireless 
network. Enter your wireless password to connect the 
Pi Zero W to the network. 


feature 


01. Pi Zero 
The Pi Zero W board fits snugly inside 
the case. Holes provide port access. 


02. Clips 

The Pi Zero clips into the case 
using four protruding clips. It snaps 
securely to the bottom of the case. 


03. Camera Module 

The Camera Module is attached to the 
inside of the camera case lid. Like the Pi 
Zero W board, it snaps into place with the 
four plastic protrusions. 
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04. Camera Cable 

The Pi Zero W case comes with a Pi Zero W 
camera cable. With this, you connect the 
Camera Module to the Pi Zero W board. 


05. GPIO header 

The case lids are interchangeable, and one 
lid enables direct access to the GPIO pins 
on the Pi Zero W. 
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The safe cover clips on to the 
Raspberry Pi case, completely 
sealing up the Raspberry Pi. 
Perfectly shaped holes on the side 
of the case enable you to access the 
USB and HDMI ports. It makes for the 
cutest computer around. 
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The GPIO cover has a cut-out section 
that enables you to access the 

GPIO pins without removing the lid. 
Another cut-out in the base allows 
room for solder and pin edges (on 
the reverse of the board), but could 
be used for GPIO access too. 


We think the camera cover is the 
star attraction. It holds the Camera 
Module in place and resembles 

a digital camera. We can't wait to 
see what Pi Zero W projects the 
community makes with integrated 
wireless and camera functionality. 
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PI ZERO W 
PROJECTS 


Five great project ideas for you to build with your new Pi Zero W 


AMAZON gs 


mazon Alexa is an 
intelligent assistant 
making a lot of waves in 


Add a speaker to your Pi Zero W 


the tech community. Amazon sells using a Speaker pHAT 
two Alexa products: the Amazon 
Echo and Echo Dot. portable Amazon Alexa device. All USB microphone using the USB to 
Amazon has also created a you need are some speakers and USB On-The-Go adapter. 
homebrew version of Alexa for a USB microphone. Previously, you also had to 
the Raspberry Pi. Pimoroni’s Speaker pDHAT add a button to the Raspberry 
Now that the Pi Zero W has (£12, magpi.cc/2kXdZsE) is a Pi version of Alexa, but a recent 
wireless LAN, it’s a perfect neat solution. Combine it witha update has added an ‘always on’ 


mode to the Raspberry Pi build. 
Alexa now listens for a vocal 
cue, such as the word ‘Alexa’ 
and then starts monitoring. 
You can change the vocal signal 
to any name of your choosing; 
‘computer’ is a popular choice 
for Star Trek fans. 

A GitHub repository has all the 
information you need to set up 
Amazon Alexa on a Raspberry 
Pi (magpi.cc/2kXrdW2). 

There is acomplete guide here 
(magpi.cc/2kXfPcO). Frederick 
Vandenbosch has written a guide 
to installing Alexa on a Raspberry 
Pi Zero (magpi.cc/2kXkY4A). 


' 
/ 
Use a speaker and 
microphone to turn your Pi 


Zero W into a hands-free 
Amazon Alexa Echo 
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WEARABLE 
CAMERA 


The Pi Zero W case with camera 
lid lends itself perfectly to 
making a mini camera. You could 
add a button to the case using 
Sugru to build a digicam, or use a 
Bluetooth camera button (as found 
on selfie sticks). 

We also like the idea of making 
a wearable camera. Adafruit has a 
great tutorial on creating this project. 
Adafruit used a unique 3D-printed 
case, but now you can simply use the Pi 
Zero W case (magpi.cc/2kXASMw). 
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The low power draw of the Pi Zero 
W also makes it ideal for use as a 
security camera, or as an outdoor 
wildlife camera. Hook it up toa 
Zero LiPo (magpi.cc/2kxXI8YW) 
and you'll get a steady stream of 
power. Connect the Pi Zero camera 
and use the wireless LAN to send 
alerts when it detects motion. 
Take a look at Mark West's project 
(magpi.cc/2kXznhq). 


The low power draw of the 
Pi Zero W and its wireless e@ 
connectivity make it ideal for 

use as a connected node. Add 
some storage and turn it into 
always-on network storage. 

This has always been a great 
Raspberry Pi project, but it is 
especially easy with the Zero W's 
built-in wireless connectivity. 


SMART CAR DASH 


The Pi Zero W is easy to mount on a car dashboard using a Zero View 
mount (magpi.cc/2kXIsa2). You can use it as a dash cam to record 
footage. With the wireless LAN, you can connect to a personal hotspot 
(from your mobile phone). Consider checking out the open-source 
Dride project for software (magpi.cc/2lnBwijt). 
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An award- 
winning 
free and 
open-source 
software 


media centre 
Team Kodi 


OSMC 


OSMC runs a 
Kodi back end, 
but it uses its 
own interface 
and some other 
optimisations 
that the 

makers believe 
work better. 


Movies 


TV shows 


Music 


Music videos 


TV 


Radio 


Add-ons 


Pictures 


ooh dea 


“ a 
- 
4 


vA 
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new Kodi release is 

always cause for a little 

celebration. It’s one 
of the most successful, long- 
running pieces of open-source 
media software of any type, 
and it powers so many other 
popular media centres. The latest 
release of Kodi has some minor 
improvements behind the scenes, 
with an overhauled video playback 
engine which should benefit these 
other media centres in the long 
run. However, one of the biggest 
things that users of stock Kodi 
will notice is that there’s anew 
default skin that replaces the 
venerable Confluence. 
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17.0 
KRYPTON 


The premier HTPC software gets an update with a new look 
and some new tech behind the scenes 


Bare-bones 

Skins and interfaces can be changed, 
though, so before we delve into that 
let’s talk about the video playback, 
as it has had an update. 

Long story short, it’s pretty much 
the same. Additions to the new 
video player software include video 
stream selection (the different 
angles button on your old DVD 
remote) and the ability to better 
hand off video playback tasks to 
add-ons. This isn’t something 
you’re going to notice day-to-day, 
but the real achievement is that the 
previous system was completely 
replaced with the new one without 
collapsing Kodi in the process: it 


being pretty much the same means 
they did their job. It’s a good thing. 

One thing we did notice was that 
the video output from the HDMI 
worked a little better with the HDMI 
switcher in our setup: in earlier 
versions, audio from a Pi using 
Kodi would sometimes hiccup as if 
the audio stream itself just wasn’t 
making it to the TV. We didn’t 
come across this issue with Kodi 17. 
There’s still a little trouble playing 
video encoded with 10-bit colour, 
though, with no improvements 
over the previous release. That’s 
more of an issue with a lack of 
hardware decoding for 10-bit on 
the Pi than with Kodi. 
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Music videos 


TV Video add-ons 


Radio 


Add-ons 


Videos 


Favourites 


Weather 


Uitzending 
Gemist 


Uitzendinagemist (NPO 


Tweakers 


Program add-ons 


fis) 


YouTube Dumpert 


We also noticed that, while still 
supposedly supported, AirPlay was 
working worse than ever. Before, 
an Apple device could at least see 
the Kodi box although we’ve never 
actually seen AirPlay working 
between the two. Now, it simply 
doesn’t show up. It would be good if 
the Kodi guys could get that working 
consistently, but it’s a minor issue. 


said, you can’t change the order 
in which they’re listed and, for 
a device you’re probably mostly 
using to play back video, having 
the pure video option last in the 
list is not very useful. 

It runs beautifully on the 
Raspberry Pi, though, with smooth 
transitions between menus and the 
same basic structure as other skins. 


It runs beautifully on the 
Raspberry Pi, with smooth 
transitions between menus 


New look 

That brings us to the new interface, 
Estuary. It’s almost completely 
different to the old Confluence, 
with a greater focus on using 

the scraped metadata from your 
content and optimising the space 
to display said content. Inspiration 
has definitely been taken from 
modern smartphone UI and UX 
design, which makes sense as 

the way we use technology has 
changed over the years. You can 
still have your basic file selection 
if you prefer, though, and you 
actually get more control over 
which categories are listed on 

the home interface. That being 
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The settings menu is generally 
more useful and easier to navigate 
as well, although it does mean some 
extra add-on settings now live away 
from the settings menu in an all- 
encompassing add-ons field. 


Future-proof 

This new version of Kodi seems 
like a glimpse of what’s to come. 
With a more robust back end anda 
new front end to go with it, we’re 
probably going to start seeing a 
few more noticeable changes in 
the next version of Kodi. The new 
interface is great and a welcome 
change over the old Confluence one 
(although you can still install it if 


Kung Fury 


Add-ons 
can now also 
be found ina 
dedicated add- 
on category, 
though some 
Will still show up 
in the relevant 
media categories 


you prefer). Importantly, it still runs 
really well on a Raspberry Pi. We did 
most of our testing on a Raspberry 
Pi 2, which is more than likely the 
backbone for any home theatre 
setup, and it worked as well as ever, 
so there’s no worries there. 

It’s definitely a worthwhile 
upgrade over previous versions, 
so if you’re a LibreELEC user 
you should be on the lookout for 
version 8 when that comes out. 
Other HTPC OSes may be a little 
slower to integrate the new stuff, 
so you shouldn’t have to worry 
about it just yet. 


The new 
interface is arranged 
much better than 
before, and even 
has symbols to 
signify if you have 
watched or are 
part-way through 
a video 


A good upgrade to an already great piece of 
software. It still works just fine on the Raspberry 
Pi, so there's no need to overhaul your home 


theatre for it either. 


KK KK 
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Waker 
days 


Want 
to lose 
the Xmas 
dinner? 


Pl METRE 


This is your 
PiMetre Gym: 


i eo 


Join Pi Metre gy Aig 


Pi Metre 


MY 
FITNESS 
PAL 


While 
MyFitnessPal 

is great, it 
doesn't run on 
the Raspberry 
Pi. The app is 
available for iOS 
and Android. 


FREE 
myfitnesspal.com 


76. | MagPi March 2017 


= Click enter to close the locker | : 


To view your 
personal locker 
click 'L’ 


+ length: 0 vy 
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P| METRE 


A Scratch-powered fitness app for the Raspberry Pi. 
How does it help you get fit? 


he Pi Metre is a simple 
fitness app created for 
Raspberry Pi in Scratch. It 
was designed completely on Scratch 
2.0, so it’s only recently been able 
to work widely on Raspberry Pis 
thanks to the addition of Flash to 
Chromium. Luke Castle, the creator 
of Pi Metre, suggests also making a 
portable Pi setup to take it with you 
to the gym or while running, but it 
would work just as well at home. 

Pi Metre works by asking you to 
first start a workout. You do this by 
pressing E and entering the number 
of seconds you plan to work out; 
this does slow down the process 
a bit, as you need to transfer the 
minutes you plan to work out into 
seconds. The app will then count 
down the seconds and play an 
appropriate workout mix for you 
to exercise to. It lasts just over five 
minutes before looping again, so 
for longer workouts it may get a bit 


repetitive. Once the countdown is 
done, it triggers an alarm to let you 
know your workout is over. 


runs on Scratch, it will use up 
a lot of resources. It’s quite fun, 
though, anda nice little project 


You can create a portable P1 
setup to take 1t with you to the 
gym or while running 


Workout times are then kept in 
your locker, which can be accessed 
with L. Unfortunately, there’s 
no way to differentiate between 
different types of workouts, and it 
won’t calculate a calorie count for 
cardio. You get an account for the 
app as well, with the idea that you 
can save your workouts to refer 
back to them; you’1l] need to make 
sure to log off, though, to save the 
workouts properly. 

It’s avery simplistic app 
and could do with a fair few 
extra components. Also, as it 


to make so you can create your 
own portable workout countdown 
and tracker. 


fast word 


Avery simple workout app 
which is much better as a 
full Pi project than just the 


software on its own. You're 
probably better off witha 
smartphone app, though. 
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Waker 
days 


Turn 
your Pi into 
Gd Lilliputian 
ghetto 


blaster 
Pimoroni 


SPEAKER PHAt 


MINI 
PORTABLE 
SPEAKER 


Powered or 
charged via USB 
and connecting 
to the audio 

out port of a 
standard Pi (but 
not Zero), this 
mini speaker 
packs a punch. 


£12 / $15 
magpi.cc/2diQyHq 
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A tiny speaker board for adding sound to projects 


imoroni’s latest DHAT may 

not sound all that phat, 

but it does offer a neat 
way to quickly add audio to your 
projects. This Pi Zero-sized board 
manages to cram in a mini speaker, 
I?S DAC, and mono amplifier. We 
particularly appreciate the 1980s 
boombox-style artwork on the 
top of the board, complete with a 
ten-LED bar graph. 

Since the 8Q, speaker has just 

2W of power, you won’t exactly 
be rocking the neighbourhood. It 
sounds more like a tinny transistor 
radio than a ghetto blaster, 
offering little in the way of bass 
(and obviously no stereo), so it’s 
certainly no rival for high-quality 
audio add-ons from the likes of 
IQaudlO and JustBoom. But then 
that’s not what it’s intended for; 
instead, it should prove suitable for 
projects that require audio output 
for notification sounds or speech. 
Indeed, it would be ideal for the 
digital whoopee cushion in this 
issue, precluding the need to wire 


up a Separate powered speaker. 
Other use cases include a retro 
gaming handheld or — by pairing 
it with a mini microphone — a DIY 


command. It should then work as 
the default audio output, although 
you may need to reboot the Pi first. 
We tested it out with aplay and 


Itis nevertheless a great way 
of adding audio to projects 


voice assistant based on Amazon 
Alex or the like. 

The Speaker pHAT comes in kit 
form, requiring about 30 minutes to 
assemble. First, you need to screw 
the speaker to the rear of the board, 
using tiny spacer nuts, which is a 
little fiddly. Then it’s time to get 
the soldering iron out. Soldering 
the speaker’s two terminals to the 
board contacts with the supplied 
24AWG wire is a bit awkward and 
you need to use tweezers to hold 
the bare wire as it gets hot! It’s 
then simply a matter of soldering 
on the 40-pin female header and 
the pHAT is ready to use. 

Installation of the software is 
achieved with a single terminal 


mplayer from the command line, 
as well as Sonic Pi and YouTube 

in the Chromium web browser. 
There’s also a library for manually 
controlling the LEDs if you want. 


fast word 


Not one for audiophiles, 
the Speaker pHAT offers 
rudimentary sound quality 
with Little power. It is 
nevertheless a great way of 


adding audio to projects, with 
its tiny Zero-size footprint and 
no need for a separate power 
supply. It looks cute too. 
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Right The Cluster HAT sits on top 
of a Raspberry Pi 2/3 board 


Waker 
says 


Ideal tool 
for teaching, 
testing or 
Simulating 
small-scale 


clusters 
pimoroni 


PICO 5 
STARTER 
KIT 


PicoCluster 

has a range of 
cluster kits fora 
range of boards 
(including the 
Raspberry 

Pi). They use 
Ethernet 
networking 

and Raspberry 
Pi 2/3 boards, 
but are more 
expensive. 


£189 / $239 
magpi.cc/2kAcJLG 
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CLUSTER HAT 
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Make a cluster computer with a Raspberry Pi and four Pi Zeros 


uilding a computer 
cluster is one of the most 
impressive Raspberry 

Pi projects. And being able to 
program cluster computers is one 
of the most highly valued skills in 
the world of big data. 

A cluster is a set of computers 
networked together and used as 
a single system. Each computer 
(or ‘node’) is scheduled to work 
on the same task, controlled by a 
master computer. 

Knowing how to manage, 
and use, clustered computers 
and supercomputers is a pretty 
valuable skill. It’s also one of the 
areas at the absolute forefront of 
computing technology. 

But it has always been difficult 
to get started. Traditionally, cluster 
computing has been an expensive 
hobby. You need lots of computers 
(preferably identical) anda 
network controller and the skill to 
network them all together. This 
difficulty is before you even start 
learning how to manage several 
computers working in tandem. 


On top of all that, it can be 
expensive to run multiple full- 
sized computers. Energy costs 
quickly ramp up when you're 
running a cluster. 


Hat on it 

The Cluster HAT removes the 
expense and effort required 

to create a cluster. This lower 
barrier to entry makes it a lot 
easier to get on with the more 
important act of learning cluster 
computing technologies. 

The HAT sits on top of 
a Raspberry Pi 2/3 and you slot four 
Pi Zero computers on to the HAT 
(via the USB connection). 

A USB cable is run from the 
Raspberry Pi to the HAT to provide 
power to the four Pi Zero boards. 
The latter are controlled directly 
via the GPIO pins. 

You need a microSD card for each 
Pi Zero, and one for the controlling 
Raspberry Pi. So that’s five SD 
cards in total. 

We costed up a Raspberry Pi, 
Cluster HAT, four Pi Zero boards, 


and four official microSD cards 

— it comes to £102. That’s by far 
the cheapest cluster computer 

you will find on the market. For 
those looking to get into cluster 
computing, this is a game-changer. 


Getting started 

Setting up the Cluster HAT 
hardware was an absolute 

breeze. Screw the four pins on 

to a Raspberry Pi 3 board and 
insert the supplied USB cable, 
then attach the HAT (wiring the 
cable between the board and HAT). 
Attach the USB power to the HAT 
and then slot on the four Pi Zero 
boards. The whole setup took less 
than five minutes. 

Software is well handled too. A 
dedicated site (magpi.cc/2j)HMeQq) 
provides image files for the 
controller (the Pi 2/3) and one 
image file for each Pi Zero board. 

The Cluster HAT version 
of Raspbian boots into the 
command line, but offers a 
script for controlling the cluster. 
For example: 
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clusterhat on all 


This command-line code 
switches on all four Pi Zero 
boards. You can also control them 
separately, using p1-4. Such as: 


clusterhat p2 off 
clusterhat p2 on 


It takes a few moments for 
each Pi Zero to power up and load 
its software, at which point it’ll 
appear in ifconfig. 

Access each node using SSH 
(enabled by default): 


ssh pi@p1.local 


Here you can use ifconfig to 
find the IP address Cluster HAT 
has assigned to the Pi Zero 
(under USB Ethernet). 


Pj computing 
One thing this isn’t, though, is a 
supercomputer. There’s a good set 
of benchmarks by Nick Smith on 
Climbers.net (magpi.cc/2jKlq23). 
Nick used iperf to test the 
network-over-USB connection and 
found it comparable to Ethernet. 
The slower speed of the Pi Zero 
boards compared to Raspberry Pi 2/3 
boards is much more pronounced. 
Nick benchmarked the system 
using HPC Challenge Benchmark 
(magpi.cc/2j/KpH5C). He found 
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the cluster of four Pi Zero boards 
ran at roughly half the speed of 
a single Raspberry Pi 3 board. 

The slower speed makes sense 
when you think about it. Nick 
explains: “This is partly down 
to the faster individual cores in 
the Pi3, but also the node-node 
communication is obviously 
a great deal faster within the Pi 3 
SoC compared to communicating 
between separate Zeros with 
Ethernet-over-USB.” 

So you’re not building a faster 
Raspberry Pi. However, we 
don’t think this matters. The 
aim for most people will be to 
build a low-cost and relatively 
easy-to-assemble cluster for 
educational purposes. 

Once created, you can start to 
experiment with the concepts 
behind cluster computing. The 
Cluster HAT is ideal for teaching, 
learning or developing cluster 
computing ideas. 

We suspect it will also appeal to 
developers who have access to larger 
cluster computing systems, but 
not all the time. You can test and 
run code on the Cluster HAT, then 
migrate it across to a larger system. 


Distributed computing 
Cluster computing is not a game 
for beginners. Realistically 
speaking, prospective learners 
will need a working knowledge of 


CLUSTER HAT 


Python, Java, SQL (and relational 
database techniques). You’|l also 
need a good understanding of 
the Linux command line. 
Fortunately, starters are 
not alone. There’s a vibrant 
Cluster HAT Google Groups board 
(magpi.cc/2jHYqk6). There are 
lots of resources and projects 
being shared by the community. 
One book that is recommended 
reading is Raspberry Pi Super 
Cluster (£16.78) by Andrew K 
Dennis (magpi.cc/2jHZyV8). 
Whatever resources you choose, 
we think the Cluster HAT is a great 
resource for starting distributed 
computing. It’s small, cheap, and 
easy to set up. 
You have to leap a lot of hurdles 
to learn cluster computing. 
But Cluster HAT removes 
the expensive and difficult 
hardware build. It’s then up to 
you to learn the sophisticated 
coding techniques. 


fast word 


A compact, neat and cost- 
effective solution to building 

a cluster computer. The end- 
product might lack raw power, 


but it’s perfect for teaching 
and learning distributed 
computing concepts. 


Above Left The 
USB sockets on 
the Cluster HAT 
provide connection 
for four Pi 

Zero boards 


Above Right The 
Raspberry Pi 3 
board is the only 
device using 
Ethernet. Network- 
over-USB is used 
to hook up the Pi 
Zero boards 
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TECHNICAL 
BESTSELLERS 


Dr James Stone’s Tutorial books for 
Sebtel make technical, mathematical 
subjects easily understandable. 


BAYES’ RULE: 


A TUTORIAL INTRODUCTION 
TO BAYESIAN ANALYSIS 


Author: Dr James Stone 
Publisher: Sebtel Press 
Price: £14.95 

ISBN: 978-0956372840 

magpi.cc/2lFLqx5 


The revival in interest in Bayes’ 
theorem - studying probability 
based on information we have 

- has found a use in many 
fields. This is possibly the best 
general introduction to the field. 
Recommended. 


INFORMATION 
THEORY: 


A TUTORIAL INTRODUCTION 


Author: Dr James Stone 
Publisher: Sebtel Press 
Price: £16.95 

ISBN: 978-0956372857 

magpi.cc/2LFOwRp 


An outstanding introduction 
that can pullin the general 
reader with dry humour, but 
has the textbook rigour needed 
by programmers looking for 

a fuller understanding of this 
essential subject. 
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BAYES’ RULE 


WITH PYTHON cul 


Author: Dr James Stone 
Publisher: Sebtel Press 
Price: £19.95 

ISBN: 978-0993367939 

magpi.cc/2lFLqx5 


The Bayes book, with inline 
Python code examples of the 
probability problems. Also 
available in R and Matlab 
flavours. Very handy for helping 
to work through tougher 
examples in Jupyter Notebook. 
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PYTHON, PYGAME 
AND RASPBERRY PI 


GAME 


DEVELOPMENT 


Author: Sloan Kelly 
Publisher: Apress 
Price: £14.99 

ISBN: 978-1484225165 
magpi.cc/2lFOdGy 


Writing games 
remains one of 
the best ways to 
motivate learners 
through some of the challenges 
of learning to code. The Pygame 
library provides enough abstraction 
to let the reader produce working 
games relatively easily, without 
hiding away anything of real 
educational value. Marketed at 
Pi users, Kelly’s fine tutorial can 
be used on any computer where 
Pygame is installable. 

Hello World is preceded by 
a useful introduction to data types 


THE BIG BOOK OF 
MAKERSPACE 


PROJECTS 


hers to Expein, an 
6 ene 


Authors: Colleen Graves, 
Aaron Graves 

Publisher: McGraw Hill 

Price: £15.99 

ISBN: 978-1259644252 

magpi.cc/2lFLINM 


Learning programming 
has well-established 
routes, such as Hello World, 
loops, and variables, but what’s the 
beginner maker to do? The Graves’ 
excellent collection of projects will 
build up your skills, then challenge 
you to go further. Hello World 
here is the Brushbot Warrior, 
repurposing everyday equipment, 
then proceeds via Scribble Bots to 
a host of other moving projects. 
After circuits, coding, and 
smartphone projects (DIY 
projector), we’re back to non-tech 
skills, with some great musical 


The Big Book of 


Li 5 
Vi f ; rR ) followed by challenges, 
! KE; % 


20PACK 


Projects , 


and programming styles — who 
knew pencils were object-oriented? 
— then followed by programming 
basics, all with reference to parts 
of typical games. The writing style 
and short chapters give a pleasing 
forward momentum, and we’re soon 
at our first game. 
After due recognition to design 
and testing, there’s Bricks, a 
classic Breakout-style game; 
always a good teaching example, 
with movement and collision. 
Building on this example, object- 
oriented programming is explored 
fully; there’s a lot here, but some 
of it gets reinforced in the next 
game, Snake. MVC is introduced 
for Robots. Final chapters cover 
sound and finite-state machines, 
wrapping them up with a game of 
Invaders. Not always easy going, 
but this well-paced introduction 
to programming will rapidly carry 
newbies a surprisingly long way. 


Score 


instrument builds. After sewing 
circuits, more electronics; the 
supply listings are localised to US 
suppliers, but it shouldn’t take too 
much effort to track things down 


wherever you are, locally 
as well as through the 
internet. Projects are 


suggesting you step beyond 

following instructions and 

make projects your own. 

Every maker needs some 

of these projects in her 
armoury, ready to build with 
the next person who asks “what’s 
it all about, then°”. If you’re new to 
making, there are plenty of cheap 
and easy projects to build skills and 
confidence. Many of these will be 
ereat to run on makerspace open 
days. And if you’re an old hand, the 
challenges and harder projects are 
well worth trying out. 


Score 
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APACHE SPARK 
IN 24 HOURS 


computing, to machine learning 
and message queues. RDDs are 
in-memory data structures which 
are part of Spark’s speed and 
efficiency; the Spark Core 


Author: Jeffrey Aven 
Publisher: SAMS 
Price: £27.99 

ISBN: 978-0672338519 
magpi.cc/2|LFUBot 
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Apache 
Spark 


Apache Spark is 
an essential tool 
for tackling big 
data, providing 
an API for data 
processing in Scala, Java, R, or 
Python. Aven’s book focuses 

on Python and, beyond a basic 
comfort in that language, assumes 
no particular knowledge on the 
part of the reader. It introduces 
everything from Scala to Hadoop 
before tackling a range of Spark 
topics with Python examples. 

The tools of the trade for big data 
and Spark are introduced one by 
one, from Hadoop and MapReduce, 
through Resilient Distributed 
Datasets (RDD) and cloud 


A BEAUTIFUL 
ANARCHY 


Author: David DuChemin 
Publisher: Rocky Nook 
Price: £14.99 

ISBN: 978-1681982342 
magpi.cc/2lFTBtg 


A very personal 
manifesto, written 
for anyone witha 
calling to make, 
whether it’s a 
painting or a great business. 
“We’re all creative,” says the 
author, “but we’ve allowed art 
to co-opt the word.” Many take 
default choices rather than the 
difficult path of trying to write 
that novel they know they have 
in them, or set up that business. 
This is acall “to step out of the 
comfort zone, and face the fear.” 
Praising bad ideas, constraints, 
and the art of exclusion, 
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API is the other Key to 
Spark’s success, respecting 
a strongly functional style 
of programming. 

R, SparkR with RStudio, 
and Scala get chapters, and 
it’s great to see functional 
programming in Python 
getting treated as well as 

in Scala; however, that 
chapter also squeezes in 
[Python and Jupyter Notebooks, 
showing the limitation of the 

24 hour-style chapters. Final 
chapters on administering, 
extending, monitoring, securing, 
and improving the performance of 
Spark give the reader everything 
she needs to go further — a solid 
foundation for Spark with Python. 


Score 


DuChemin returns to the same 
theme from a different angle: 
you have a creative urge inside 
you, so stop making excuses, 
and start facing up to the 
difficult journey to writing 
that novel, starting that 
business, or painting that 
picture: “Living a great 
story is much harder than 
watching a great story.” 
This is a book about 
choices; those we make or 
those we abdicate all have 
an effect on our creations. 
It gets the reader to ask 
themselves questions about 
what they want in life. What 
dreams do you still hold onto? 
This call to colour outside 
the lines, and DuChemin’s 
questioning, have a way of getting 
under your skin and making you 
ask those difficult questions. 


Score 
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ESSENTIAL READING: 


R FOR STATS 


While Python nips at R's heels, R remains great 
for statistics and many general data tasks. 


The Book of R 


Author: Tilman M Davies 
Publisher: No Starch 
Price: £39.99 

ISBN: 978-1593276515 
magpi.cc/2lLGOYkf 


Combines a programming tutorial with 
an introduction to statistical methods, 
succeeding well at both tasks. Strongly 
recommended for newbies. 


A Course in Statistics with R 


Authors: Prabhanjan N Tattar, 
Suresh Ramaiah, 
B G Manjunath 
Publisher: Wiley 
Price: £70.00 
ISBN: 978-1119152729 
magpi.cc/2lLFV5Uj 


Despite occasionally idiosyncratic 
English, this is a wonderful deep dive into 
statistics strongly integrated with R code. 


Efficient R Programming 


Authors: Colin Gillespie, Robin Lovelace = 
Publisher: O'Reilly ie. 
Price: £28.50 

ISBN: 978-1491950784 


magpi.cc/2lFOUZE Efficient R 


Programming 


Essential next step in learning R - 
efficiency in programmer (your) time,and = __ 
eliminating bottlenecks through deeper 
language understanding. 


Statistical Shape Analysis: 
With Applications in R 


Authors: lan L Dryden, Kanti V Mardia 
Publisher: Wiley 

Price: £65.00 

ISBN: 978-0470699621 
magpi.cc/2lLFK1GK 


Statistical methods applied to shape 
analysis. Great for biologists, but strong 
mathematical treatment and accompanying 
code expands possible applications. 


Categorical Data Analysis 


by Example 
DATA ANALYSIS 


Author: Glanam JG Upton EXAMPLE 
Publisher: Wiley A A 
Price: £80.50 
ISBN: 978-1119307860 
magpi.cc/2lG6930 


CATEGORICAL 


Concise introduction to dealing with 
categorical data (with supporting R code) 
which will help the general data scientist. 
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FEATURE 


EUROPE'S INCREDIBLY BIG FREE 
SOFTWARE DEVELOPERS MEETUP 


In medieval times, 10,000 was the population of a major city. For one weekend each 
February, it’s the number of free software developers attending FOSDEM in Brussels 


is an entirely free event 


with no registration. It’s certainly 


very big! Now in its 18th year, 


FOSDEM has been referred to as ‘a 


week-long event happening over 
a weekend’. Indeed, it feels very 


concentrated, with dozens of talks 


happening at once (610 speakers 
in total), almost all rooms full to 
capacity, and busy project stands 
spread over several buildings. 
The conference runs on 
eoodwill, volunteer energy, and 
a modest amount of discreet 
sponsorship (plus coffee and 
Belgian beer). While all talks are 


OPENING 
THE LEDGER 


Free software developers don't just pick the 
fun stuff - Software Freedom Conservancy 
was discussing its work on new ledger- 
based accounting software for not-for-profit 
organisations, something the third sector has 
been demanding for many years. 

And on a global scale, Evan Schwartz was 
talking about tackling the mess of incompatible 
digital payment systems with W3C’s InterLedger 
project, an inter-networking protocol for money, 
with many parallels to the way the internet 
itself works. 

The slides and white paper are available here: 
magpi.cc/ 2lovKHy 
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en thousand attendees is 
a guesstimate, as FOSDEM 


in English, and many Americans 
fly in to attend or speak, the 
corridors buzz with geeky chat 

in Flemish and French, and 
Scandinavian and Slavic languages 
abound. This is Europe’s developer 
meetup; it exists because it’s 
important for free and open source 
software developers to be able to 
meet in real life. 

With 55 tracks over 30 rooms of 
the Université Libre de Bruxelles, 
you’ ll find not just your favourite 
projects, but many new discoveries. 
This year’s event included languages 
from GNU Guile to Python, 
technologies from containers to 
microkernels, and hardware projects 
covering everything from the 
embedded space to chip designers. 
Add in documentation, design, 
and community management, 
and FOSDEM has the entire free 
software and open hardware 
ecosystem present. 


Introductory music 
There’s no room on these pages 
to even list the 600+ talks, so 
here’s a tiny flavour of all that 
was on Offer. Let’s start with 

the arts. Music in particular is 
often well-represented at techie 
events, and one outstanding free 
software project is MuseScore, 
which makes it easy to produce 
ereat-looking sheet music that can 
also be played back through the 
project’s soft synthesizer. 


The project featured in the 
design track, as its usability 
research was profiled. It was also 
featured in a talk on OpenScore, 
which is crowdsourcing MuseScore 
digitisation of out-of-copyright 
sheet music to build a vast library 
of semantic score data, open for 
analysis with tools like MIT’s 
music21, as well as freely accessible 
sheet music. Partners for OpenScore 
include the IMSLP public domain 
sheet music library: imslp.org. 

Good as it was to see some old- 
school analogue synths in the slides 
of Python developer Yann Gravrand, 
it was even better to hear a live 
demo of them being controlled via 
Python by his old MIDI drum pads, 
and the mido and portmidi libraries. 

More exotic languages were 
used by Belgian digital artist 
Francois Zajéga in the Open 
Game Development devroom. He 
demonstrated sounds from the 
Pure Data language, with Ogre3D 
visuals on the Polymorph video 
game platform, suitably impressive 
visuals and music, dancers, and 
artists. His presentation is available 
here: magpi.cc/2louvlf. 

There were more visual arts from 
swarms of lightweight (27 grams — 
less than an ounce!) Crazyflie 2.0 
drones, painting, climbing, and 
commanded by a MIDI glove. Drones 
were also flying over the attendees 
in the GoLang rooms, where 
systems programming included IoT. 
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Thanks to FPGAs, says Philipp 
Wagner, we can replace slow 
waterfall design processes with 
agile methods and rapid iteration 


Pi’s subtle presence 
The Raspberry Pi is very well 
established to the point that it’s 
not much talked about. However, 
it was quietly working on many 
displays, such as Automotive 
Grade Linux (running on Yocto and 
OpenEmbedded), in ports of much of 
the software from the Kolab images 
to experimental builds of Haiku 
and Ilumos, and in NextCloud’s 
Pi 3-based Dropbox replacement. 
Ben Nuttall was there to fly the 
flag for the Raspberry Pi Foundation, 
and talk about HATs. If you’re 
interested in building your own HAT, 
with entirely free and open-source 
tools including the board design, 
watch the video of Leon Anavi’s talk. 
And look out for a feature on Anavi’s 
HAT in these pages soon. 
Python got its own full day of 
lectures: everything from how 
data structures are implemented 
in CPython, to Python in the 
cloud. Roberto Colistete Jr talked 
about ‘Scientific MicroPython for 
Microcontrollers and IoT’. BoF 
sessions were held outside the 
lecture room, and posters revealed 
how much internet giants like 
Facebook use Python. It’s a sort of 
mini PyCon, with bonus sidetracks. 
Etiene Dalcol spoke about making 
wearables with NodeMCU, a Lua- 
based language. Interesting ‘niche’ 
languages were well-represented, 
although the regular visit from 
Belgium’s Ada group is sadly a 
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thing of the past. Guile, the Scheme 
dialect used in many GNU projects 
and particularly in GUIX, featured 
many interesting sessions. Of these, 
MagPi readers may be interested in 
‘Natural Script Writing’, featuring a 
Guile dialect with whitespace, which 
“makes the transition from Python 
to Lisp seem a lot less scary.” 


Sharing knowledge 
Documentation is a concern for 
anyone trying to get things done 
with a piece of software. Rich 
Bowen had some great advice for 
those responsible, stating that 
documentation — including IRC 
channels — sets the tone for your 
project. How welcoming are you to 
new users? If you find new users not 
sticking with your project, takea 
listen to his presentation. 

At the top end of the document- 
handling scale, XWiki was doing a 
sterling job of presenting itself as 
a useful alternative to Microsoft 
Sharepoint. The humble TikiWiki 
was also present as part of the 
WikiSuite tools, offering secure, 
self-hosted software for ‘data- 
driven’ organisations. 

Knowledge was on offer 
everywhere: a chance hallway 
meeting with Nikita Voloboev 
offered the chance to try large 
mind maps of scientific knowledge: 
magpi.cc/2l0QNcP. Sharing must 
be balanced with privacy, and pp 
(pretty Easy privacy) was pushing 


FREE CHIPS 
(NOT FRITES) 


easy cryptography for the masses. 
The crowded Decentralised Internet 
devroom also offered a roadmap 
for the next few years’ defence 
of privacy. 
Daniel Stenberg, the creator 
of the ubiquitous tool curl, gave 
a talk named ‘You know what’s 
cool° Running on billions of 
devices’, about the unexpected 
demands of maintaining code that 
everybody’s using. There were talks 
on legal issues and community 
development, lightning talks, 
considered keynotes, file formats 
in open media, and data formats 
in many languages. Some of the 
most interesting talks were in the 
Software Defined Radio devroom. 
FOSDEM has evolved over the 
years, gradually embracing some 
elements of the upstart maker 
community, as well as embedded 
development (particularly 
Automotive Grade Linux), and 
even chip design. By far, the best 
of FOSDEM remains the corridor 
conversations, which are a great 
opportunity to meet programmers 
and other free software advocates of 
all backgrounds. But if you missed 
it, you don’t have to wait for next 
year — take a look at the magnificent 
archive of technical talks at 
fosdem.org/2017. 
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THE MONTHIN 


Everything else that happened this month in the world of Raspberry Pi 


e launched a sister magazine 

last month called Hello World, a 

free computing magazine aimed 
specifically at educators. The reactions 
to it have been fantastic, with attendees 
of the Bett Show and other educators 
around the UK (and indeed the world) 
excited to get their hands on a copy. 
You can find out more info on how to 
eet one yourself at helloworld.cc, and 
help kids and teens learn more about 
computing everywhere. 


BASED ON THE UNTOLD TRUE STORY 


r 


MEET THE WOMEN YOU D 
BEHIND THE MISSION 


. HIDDE 
FIGUR 
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Gemma Sanderson 


Should be preparing for #tn 
what's arrived @Hel 


.) Mr Adam Rooney 


athe 
Some good magazines here to come up with 
some exciting new classes for next term @.. 
@HelloWorld Edu @tes @ocr_ ict 


S> Fotew 


angus but look 


S> Follow 


‘ . , Richard Smith 2 Fotow 
=e 

Used the great helloworld magazine with a 
small group of students. Wonderful ideas. Free 
for educators @mberry @HelloWorld Edu 


£2 Cloghans Hill NS 23> Follow 


Thank you so much we r thrilled 
with our special delivery of 
it's amazing o 
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THIS MONTH IN PIL QQ Ti 


CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


NNUUUCUO EEE EOEOEE oe 


PI18690 HAT 
MIEARM Pi FARM PI BATTERY HAT 


ee ee 


If you cast your minds back a little while, you may 
remember that we reviewed the excellent MeArm robot 


arm — it’s pretty popular in the Pi community, even While not boasting a very descriptive name, the 
though you need to do some rejigging to get itworking Pi18650 HAT allows you to plug in 18650 rechargeable 
with it. It’s no surprise, then, that the team behind it Li-ion batteries to power the Raspberry Pi. The 

are making a Pi-specific version, and have asked the HAT fits on older 26-pin Raspberry Pis as well, and 


community to help fund it, which they didinlessthan — offers anew way of enabling portability for the Pi. 
12 hours. They’re currently at 300%, so it’sagreattime It’s smashed its funding target, so get on board now 
to jump on and get your own kit. to get one to boost your portable projects. 


BEST OF THE REST things res this month 
things we saw this month 


magpi.cc/2kQp5NT 


GBAP] RUNMYROBOT GUEST WIFI 


magpi.cc/2kQAOfw magpi.cc/2kQJgjn 
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David joined 

us at the St James's 
Palace Community 
celebration, mingling 
with the likes of the 
Duke of York, plus 
organisers of Jams 
and clubs, such as 
Grace and Femi 


A Raspberry Pi maker and student, who plans 
to add as many letters as he can after his name 


avid’s experiences in 

computer education came 

Slightly later in life. He 
admits to not being a grade-A 
student: he left school with few 
qualifications, unable to pursue 
further education at university. 
There was, however, a teacher 
who instilled in him a passion for 
computers and coding which would 
stick with him indefinitely. 

Twenty years later, back in 2012, 
David heard of the Raspberry Pi- a 
soon-to-be released “new little 
marvel” that he instantly fell 


for, head-first. Despite a lack of 
knowledge in Linux and Python, 
he experimented and had fun. He 
found a Raspberry Jam and, with 
it, Pi enthusiasts like Mike Horne 
and Peter Onions. The projects on 
display at the Jam were enough 
to push David further into the 
Raspberry Pi rabbit hole and, after 
working his way through several 
Python books, he began to take 
steps into the world of formal 
higher education. 

With a MOOC qualification 
from Rice University under his 
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David's determination to access and complete further 
education in computing has earned him a three-year PhD 


Self-playing xylophones, Wiimote air drums, Lego sorters, Pi Wars robots, 
and more. David is continually hacking toys, giving them new Pi-powered life 


WEI, Ine COM MANISal VS) ihompeieenre 
upon his self-taught knowledge 
and was fortunate enough to be 
accepted to study for a master’s 
CESrSe iin (Comm Hue SC eSmCe ai 
the University of Hertfordshire. 
With a distinction for his final 
dissertation, David completed 
the course with an overall 


His website, the pun-tastic Pi 
and Chips, is home to the majority 
of his work; David also links to 
YouTube videos and walk-throughs 
of his projects, and relates his 
experiences at various events. 

If you’ve followed any of the 
action across the Raspberry Pi 
social media channels — or indeed, 


Despite a lack of knowledge 
in Linux and Python, he 
experimented and had fun 


distinction for his MSc and was 
recently awarded a fully funded 
PhD studentship with the 
Knowledge Media Institute. 

The portfolio of projects 
that helped him to achieve his 
many educational successes has 
provided regular retweet material 
for the Raspberry Pi Twitter 
account, and various blog entries 
have been penned to highlight his 
fun, imaginative works. 

His builds have travelled to 
a range of Jams and made their 
way to the Raspberry Pi and Code 
Club stands at Bett, as well as 
to the birthday celebrations for 
the tiny microcomputer. 
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read any previous issues of The 
MagPi magazine — you’!l no doubt 
have seen a couple of David’s 
projects. The 4-Bot, a robotic 
second player for the family game 
Connect Four, allows people to go 
head to head with a Pi-powered 
robotic arm. And believe us when 
we say that it’s not as easy to beat 
as you’d hope. Then there’s his 
more recent air drum kit, which 
uses an old toy found at a car boot 
Sale, plus a Wiimote, to make a 
functional air drum displaying 
David’s toy-hacking abilities... 
and his complete lack of rhythm. 
He does fare much better on his 
home-made laser harp, though! 


studentship. Not bad for a “Lousy student” 


March 2017 MagPi 


87 


88 | 


MagPi March 2017 


FEATURE 


. 


A ey i A 


INTERNATIONA 


Code Club helps get kids coding around the world. Here’s how... 


f you haven’t yet heard 
about it, Code Club is 
a global network of 
volunteer-led extracurricular coding 
clubs for children. 

Code Club first started in the 
UK, back in 2012, to help children 
develop coding skills. Since then, 
this idea has spread around the 
world and there are now over 9,000 
Code Clubs internationally. 

In 2016, Code Club officially 
launched its international 
programme (Code Club 


HOW TO START A CODE CLUB 


Code Club is completely free and it's very easy to run 


your own. All you need is: 


> Avenue - this could be a local school, 


library or community centre. 


> Avolunteer — that's you! 


> Children to take part in the club. 


International, magpi.cc/2lfaGNm). 
Code Club partners with local NGOs 
(not-for-profit organisations). 
These share the mission to have a 
Code Club in every community in 
the world, and support the country’s 
local Code Club community. 

Currently there are Code Club 
partners in ten countries. Code Club 
Australia, the biggest community 
outside the UK, has over 50,000 
children attending Code Clubs 
(magpi.cc/2lgjyiE). In fact, in 2016 
they set a world record for the 


most kids coding at a single event. 
“Coding is the language of the 21st 
century”, says Kelly Tagalan from 
Code Club Australia. “Our mission is 
to make sure every Australian child 
has the opportunity to learn how to 
code, no matter where they live or 
what school they go to.” 


Global volunteers 

Anyone can Start an individual 
Code Club in their local community, 
anywhere in the world (see ‘How 

to Start a Code Club’ below). There 


Once you are ready to go, all you need to do is 


register on the Code Club International website and 
verify that your club is active. You'll get online access 


to a club account where you can find free resources 


to use in your club, such as posters, badges, and 
certificates. And you will be able to use the free 
curriculum of Scratch, HTML/CSS, and Python 


projects to teach in your Code Club. 
Visit Code Club World: magpi.cc/2kBa6JL. 
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CODE CLUB INTERNATIONAL 


Inspire kids to become the next 
generation of digital makers 


r,. ~s 


are Clubs all around the globe, 
in countries such as Mauritius, 
Bermuda, Nigeria, Kazakhstan, 
the Philippines, and Israel. 

Code Clubs come in all shapes and 
sizes and some of the most powerful 
Code Clubs make a big difference for 
a very small number of local kids. 

Max Dolgikh runs a Code Club 
in Ukraine. He’s been teaching 
students to use Scratch. One 
Ukrainian boy, Vova, wrote a version 
of the classic game Arkanoid. “I was 
happy all day long,” says Max. “It’s 
worth teaching to just a single child 
to give them a better life.” 

Volunteering at a Code Club is a 
eood way for STEM graduates to pass 
on coding skills while developing 
communication skills. 

“T have the opportunity to 
share my knowledge with young 
people in my community,” 
says Shohel Rana, a Code Club 
volunteer in Bangladesh. “At the 
Same time, these experiences 
taught me to communicate 
concepts to a group, skills that will 
serve me in the future.” 


Volunteering is also a good thing 
to do. “I feel really happy when I am 
volunteering at Code Club because 
I feel a sense of real achievement,” 
says Mizanur Rahman, a Code 
Club volunteer in Bangladesh. 
“These children do not have big 
ambitions and they think of doing 
similar jobs as their poor parents,” 
explains Mizanur. “At Code Club, 
we provide a creative platform. 
They can express themselves with 
confidence and learn skills with 
better career prospects.” 

Code Club is looking for 
volunteers around the world. 
Anyone can start an individual Code 
Club in their local community. 

Start a Code Club in your local 
area and you’ll get to inspire the 
next generation of digital makers. 
Visit Code Club International and 
don’t forget to register your club. 
Class projects are completely free, 
and available in 25 languages — from 
French and Spanish to Korean, 
Arabic, and Hebrew - for registered 
Code Clubs. Visit magpi.cc/2InuqLL 
to see how you can help. 


aE = 
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Code Club students in 
Ukraine are learning 
computer science skills 


Community 


CODE CLUB 


INTERNATIONAL 
IN NUMBERS 


OFFICIAL 
COUNTRIES 


9000+ 


CODE CLUBS 
WORLDWIDE 


100,000 


KIDS HAVE ATTENDED 


LANGUAGES 
FOR PROJECTS 


120+ 


COUNTRIES 
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Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


EVENT CALENDAR QO itistinate® ges 


#PDATTHECOTTAGE 
RASPBERRY JAM 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 

ben@raspberrypi.org 


VF 


FANG TSILNG Ist Tel) ley eINIS REGULAR EVENTS 


3RD ANNUAL HISAR #PDATTHECOTTAGE PRESTON RASPBERRY JAM 
CODING SUMMIT RASPBERRY JAM When: Monday 6 March 
When: Friday 10 — Saturday 11 March When: Saturday 25 March Where: Media Innovation Studio, 
Where: Hisar Okullari, Istanbul, Where: 619 Elm Street, Minden, Preston, Wik 
Turkey LA, USA magpi.cc/21IZNExP 
magpi.cc/2ktyM3C magpi.cc/2ktjUIM A community of people who meet 
Sharing and spreading essential The inaugural Louisiana Raspberry each month to learn, create, 
knowledge of programming and Jam: discover the world of and share the potential of the 
algorithmic thinking. Raspberry Pi and what it can do. Raspberry Pi computer. 
BLAYDON RASPBERRY JAM DUNDEE MANCHESTER 
When: Saturday 11 March RASPBERRY JAM RASPBERRY JAM 
Where: Blaydon Library, When: Saturday 25 March When: Saturday 11 March 
Blaydon, UK Where: Dundee MakerSpace, Where: The Shed, Manchester, UK 
magpi.cc/2ktAFwS Dundee, UK magpi.cc/2k476Wn 
The first Blaydon Jam. If you’re magpi.cc/2ktArof Bring your Raspberry Pi along 
interested in Raspberry Pi Get along to the Dundee and take part in the workshops. 
computers, join in: mingle, MakerSpace and learn about the There’s also a getting started 


learn, share, and enjoy. Raspberry Pi microcomputer! session for newcomers. 
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STAFFORD 
RASPBERRY JAM 
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c) PI WARS 


STAFFORD 

RASPBERRY JAM 

When: Tuesday 14 March 

Where: Stafford Library, 
Stafford, UK 

magpi.cc/2lzwyQu 

A big meet-up of Pi enthusiasts 

who all share ideas, help each 

other, and most of all have fun! 


P!| WARS 

When: Saturday 1 - Sunday 2 April 

Where: Computer Laboratory 
(University of Cambridge), 
Cambridge, UK 

magpi.cc/2k48U1D 

Pi Wars is back! The spin-off of the 

CamJam pits Pi-robots against each 
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other in a Series of tricky challenges. 


Community 


H E AT. IV A LV) EvERVIVEE 


CAN YOU HELP INCREASE 
THE AMOUNT OF JAMS 
IN THE AREAS THAT NEED MORE? 


MORE WAYS TO LEARN 
CODE CLUBS (i ieee ab 


The latest figures show there sae 
gre over 5,000 Code Club after- | 7 

school or extracurricular clubs 
around the UK, any of which 
you can join to learn more 
about computing. That means 
there's probably one near you. 
Code Clubs offer loads of fun 
ways to learn about computing 
using Scratch, Python, or 

even web-style code. Find out 
where your nearest one is at 
codeclub.org.uk. 
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Mature users 
I am a very senior (more than 50 years’ 
experience) computer person from the USA. Iam 
also a physician health surveyor for Medicare, 
so I visit a lot of older folks, most of whom have 
been bypassed by the computer revolution. My 
experiments with Raspberry Pi indicate that this, 
in various form factors, could become a terrific 
introductory system for seniors who wish to learn 
about computing (and many of them do!). 

This is a HUGE potential application. I note 
that someone has already cobbled together 
a simplified user interface for seniors, though I 
personally would prefer that this be done at the 
OS level (I know, much easier said than done). On 
the whole, the Raspberry Pi is just taking off in the 
USA. It would be terrific if we could get something 
going with AARP to promote Raspberry Pi for the 
elderly, especially if we could produce a really 
EXCELLENT simple but capable user interface. 
stuart Jones 


That’s great that it’s helping seniors learn 
about computing in America. The Raspberry Pi 
Foundation’s mission does really revolve around 
children, teens, and other young people, which 
is probably quite apparent in the way a lot of the 
resources are written. However, as you’ve said, the 
community has come together and created some 
interfaces more suited to seniors. There’s a very 
long list of stuff that the PIXEL team has to tweak 
and add, so you may see something like that one 
day, but who knows when? 

Otherwise, it might be an idea to keep an eye on 
any new Picademy USA courses, so you can learn 
better how to educate others about the Raspberry Pi. 


‘ ,__ a a / 


Come along to a Picademy in the USA 
and learn how to teach with Pi 
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LETTERS 


A lot of 


you liked the big 
project from last 
issue and we're 
definitely planning 
to do more in 

the future 


Lost in translation 

I’ve noticed you’re doing a few translated editions 
now — the German version and the mini mags. 
You seem to have a great range of languages; 
however, I’d love to help you with translating 

it into another language. Do you have any plans 
for future translated editions? 

Marcus 


We do have plans for other translated versions of 

The MagPi, although we can’t really talk about which 
ones just yet until we’re absolutely sure they’ re going 
to happen. While we do appreciate members of the 
community offering their services, it’s a little tricky 
in many ways, because we’re a magazine and making 
sure the text is different but the design stays similar 
requires a lot of extra skills. Do let us know what 
languages you would like it translated to, though, 

as we can always try to get that on the plan. 
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FROM THE FORUM: This was a weird one, but thanks to the folks on the 
B forums, we did realise what happened... 
To begin with, they’re supposed to say GPIO and not 
WH Kk N A S C) | | FOHN. You then wire up the cover to the listed GPIO 
ports to get them to light in the right order. Simple 


enough. What seems to have happened is that during 
the design process, the illustration we used which said 


GPIO was subject to some bug that changed each letter 


The Raspberry Pi Forum is a hotbed of to the previous one on the alphabet. 

conversations and problem-solving for the Due to the way the articles are checked, it was 

community = join in via raspberrypi.org/forums nearly impossible to notice this error. Now we 
know it’s a thing that might happen, though, we 


ather late, I know (or early for 2017): I’m looking at the can make sure it doesn’t again. We’re sorry for any 
Christmas tree project. On the image of the back of the tree confusion caused! 
card, what do the characters mean next to the lights? 


What does ‘FOHN’ mean next to the light number? There is also W R IT E TO U S 
‘FOHN /1’, and ‘FOHN 05’ appears twice. ; 
Have you got something you'd like to say? 
Thanks, : 
: Get in touch via magpi@raspberrypi.org or on The MagPi 
jJonesypeter 


section of the forum at: raspberrypi.org/forums 
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WD PIDRIVE NODE ZERO 
FOR RASPBERRY PI 


Build your own mini DLNA + Samba file server, wireless mobile 
storage device, or a Pi MusicBox with local storage and more. 


Includes: 
¢ 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 
¢ SD card with starter software 

¢ Mini HDMI adapter cable 


@ WD LABS Learn more at wdlabs.wd.com/magpi55c 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 
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www.tThePiHut.com 


This issue we’ve reviewed 
version of 


Kodi and we’ve also made a tutorial 


cA 


the brand-new 


e 


on how to make your own HTPC with 


it. This Kodi case is the ideal accessory 


for your home theatre, blending in 


perfectly with your other devices. 
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Tell us by 27 March Simply email competition@raspberrypi.org 


for your chance to win! with your name, address, and answer! 


Terms & Conditions 

Competition closes on 27 March 2017. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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BC electronics enclosures for 
building automation applications 


The possibilities are endless when you add a Raspberry Pi 

The new RPI-BC enclosure for Raspberry Pi computers is part of the well-established 
BC electronics enclosure range from Phoenix Contact. The BC range is ideally suited 
to building automation & lol applications, offering endless possibilities to expand the 


functionality of Raspberry Pi computers. 


For additional information call 0845 881 2222 or visit phoenixcontact.co.uk/RPIBC 
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INSPIRING INNOVATIONS 


Column | THE FINAL WORD 


uby 


ince the original Raspberry Pi Zero came 
out, ’ve seen many makers using it for 
connected home projects. Its size, low price, 
low power consumption, and software package 

have made it a great option, even if makers had 

to use a USB peripheral to add connectivity. Now 
that wireless LAN and Bluetooth connectivity are 
built into Raspberry Pi Zero W, it makes this mini 
computer platform even better suited for home 
Internet of Things projects. 

Let me get this out of the way first: ‘Internet 
of Things’, or ‘IoT’, has all the trappings of 
an overhyped buzzword. But even if the term 
Internet of Things doesn’t stick around very long, 
the concept of connected devices is here to stay 
for good. It’s a clear side effect of increasingly 
affordable wireless connectivity technology. 

It’s not just development boards that are becoming 
more connected. The consumer electronics devices 
that we buy for our homes are more likely to have 
wireless capabilities. Even a product as simple as 
a light bulb can be equipped with connectivity, so 
that you can control its intensity and colour witha 
mobile app or home automation platform. I recently 
connected our Google Home to our WeMo Smart 
Plugs so that I can control the lights in our home 
using my voice. Last week I was carrying a load of 
laundry into a dark bedroom. Being able to say “OK 
Google, turn the bedroom lights on” and having it 
instantly do just that was a magical moment. 

As makers and technology enthusiasts, we have 
even more power available to us. We benefit from 
affordable connectivity when it arrives on hardware 
platforms like Zero W, and can create the connected 
devices that we hope to see on store shelves one day. 
We also benefit from being able to interface with 
consumer-connected devices. For example, a simple 
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MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


- CONNECTED 


OOME 


Matt Richardson on how the arrival of Zero W is perfectly timed for IoT 


hack with a Raspberry Pi lets you use Amazon 

Dash buttons to control almost anything you want. 
(Dash buttons are usually used to order a particular 
product, such as laundry detergent, from Amazon 
with just a single press.) 


Advanced loT 


If you want to go beyond the basics, there are cloud- 
based platforms that let you manage many devices 
at once, and create intelligent alerts and actions. 
Many platforms are already Raspberry Pi-friendly, 
including the Particle Cloud, Initial State, Cayenne, 
and Resin.io. Each has its distinct advantages. For 
example, Initial State makes it really easy for you 

to create custom web-based dashboards to show 
you the state of your own sensors and internet- 
connected devices. 

And if you’re a beginner, there are platforms that 
make it easy to get started with connected devices. 
One in particular is called IFTTT, which stands for ‘If 
This, Then That’. It’s an easy-to-use service that lets 
you connect consumer and maker platforms together 
without needing to write any code. IFTTT can also go 
beyond your devices: it can interact with the news, 
weather, or even local government. In the first 
partnership of its kind, the City of Louisville, 
Kentucky recently announced that it’s now on IFTTT 
and sending real-time air quality data, which you can 
log or use to trigger your own projects. I hope that 
it’s just the beginning for IoT partnerships like these. 

With all the recent developments in the Internet 
of Things realm, Raspberry Pi Zero W comes at 
the perfect time to offer affordable, portable, and 
connected computing power. The best part is that 
exploring IoT doesn’t mean that you need to go too 
far into uncharted territory... it’s still the same 
Raspberry Pi that you already know and love. 
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ESSENTIALS 
LEARN | CODE | MAKE 


OUT NOW IN PRINT 
ONLY £4/$6 
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audio player 
l\Qaudio Limited, 


Twitter: @IQ_audio 
Email: info@iqaudio.com a U 'e C) Cricklade Wiltshire. 
Company No.: 9461908 


Web: www.iqaudio.com 


WANT TO GET 
NOTICED? 


REACH THE RIGHT 
AUDIENCE FAST 


-World’s #1 Pi magazine 
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serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout PF! Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Ditferential P 


8 channel 18 bit analogue to digital 
converter. I*C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 1O Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RIC Pi Plus 


Real-time clock with battery backup 
and 5V I?C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


| Wire PI Plus 


1-Wire® to I?C host interface with ESD 
protection diode and I*C address 
selection. 


electronics 


AISO 
available 
for the 
Pi Zero 
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IES 


A Wiley Brand 
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Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pj board and case 
Power Supply and HDMI Cable 
Pre-Programmed Memory Card 
Over 40 electronic Parts 
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Available in Europe 
Available for worldwide shipping at: through RS Components 


$89” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 
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